Daftar Isi

Ikhtisar Pemeriksaan Kesehatan Metrik & Monitoring Penyiapan Peringatan Pencatatan Permintaan Pelacakan Terdistribusi Pemantauan SLA Dasbor Alat Pemantauan Praktik Terbaik

Dokumentasi API

API Monitoring, Metrik, dan Pemeriksaan Kesehatan

Pantau Smart Money API dengan pemeriksaan kesehatan lengkap, metrik kinerja, dan peringatan. Lacak uptime, latensi, tingkat kesalahan, dan kepatuhan SLA.

Diterbitkan 21 Maret 2026 • 13 menit dibaca • Operasi

Ikhtisar Pemantauan

Smart Money API menyediakan kemampuan pemantauan lengkap untuk melacak kesehatan layanan, kinerja, dan keandalan. Terapkan strategi pemantauan ini untuk mendeteksi masalah lebih awal dan mempertahankan uptime tinggi.

Tiga lapisan pemantauan:

Pemeriksaan Kesehatan — Ketersediaan endpoint dan fungsionalitas dasar
Metrik — Data kinerja (latensi, throughput, tingkat kesalahan)
Pencatatan — Detail permintaan/tanggapan untuk debugging dan audit

Metrik Target: 99.9% uptime, <100ms p95 latency, <0.1% error rate, <5 second mean time to detect.

Pemeriksaan Kesehatan

Endpoint Kesehatan API

Pemeriksaan Kesehatan
// Pemeriksaan liveness sederhana (tidak memerlukan autentikasi)
GET /health
// Respons
HTTP/1.1 200 OK
{
 "status": "healthy",
 "timestamp": 1709980800000,
 "uptime": 99.95
}

Status Kesehatan Detail

Kesehatan Detail
// Status detail dengan kesehatan komponen
GET /v1/status
  -H "Authorization: Bearer token"
{
 "status": "operational",
 "components": {
 "api": "healthy",
 "database": "healthy",
 "cache": "healthy",
 "exchanges": "healthy"
  },
 "metrics": {
 "p95_latency_ms": 85,
 "error_rate": 0.0012,
 "uptime_percent": 99.95
  }
}

Dapatkan kunci API dalam 30 detik

Siap membangun? Dapatkan kunci API gratis (100 panggilan/hari, tanpa kartu) dan mulai menarik data live whale, funding, dan on-chain.

Dapatkan kunci API →

Metrik & Monitoring

Metrik Utama yang Harus Dilacak

Metrik	Target	Ambang Peringatan
Uptime	99.9%	<99.5%
P95 Latency	<100ms	>500ms
Error Rate	<0.1%	>1%
Requests/sec	Bervariasi	Mendekati batas
Cache Hit Rate	>70%	<50%

Endpoint API Metrik

Kueri Metrik
// Dapatkan metrik API untuk pemantauan
GET /v1/metrics?period=1h
  -H "Authorization: Bearer token"
// Mengembalikan metrik dalam format Prometheus
# HELP api_requests_total Total permintaan API
# TYPE api_requests_total counter
api_requests_total{method="GET",status="200"} 4502
api_requests_total{method="GET",status="429"} 12

Penyiapan Peringatan

Peringatan Webhook

Buat Peringatan
POST /v1/alerts
  -H "Authorization: Bearer token"
  -d '{
 "name": "Tingkat Kesalahan Tinggi",
 "condition": "error_rate > 0.01",
 "webhook_url": "https://hooks.slack.com/...",
 "severity": "high"
  }'

Jenis Peringatan

Peringatan Uptime — API tidak tersedia selama 5+ menit
Peringatan Latensi — Latensi P95 melebihi ambang
Peringatan Tingkat Kesalahan — Tingkat kesalahan di atas 1%
Peringatan Batas Laju — Mendekati batas laju
Peringatan Kesegaran Data — Data lebih lama dari ambang

Pencatatan Permintaan

Tingkat Log

Contoh Log
// Entri log permintaan API tipikal
{
 "timestamp": "2026-03-21T14:00:00Z",
 "request_id": "req_abc123def456",
 method: GET,
 path: /v1/whales/btc,
 status: 200,
 duration_ms: 45,
 user_id: acct_12345
}

Structured Logging

Semua log terstruktur dalam JSON untuk memudahkan parsing dan analisis:

Timestamp dalam format ISO 8601
Request ID untuk pelacakan
Metode HTTP dan path
Status respons dan latensi
User ID dan sidik jari API key
Pesan kesalahan jika ada

Distributed Tracing

Pelacakan Request ID

Tracing Headers
// Semua request mencakup tracing headers
curl -H "X-Request-ID: req-abc123" \
  https://api.smartmoneyapi.com/v1/whales
// Respons mencakup ID yang sama
X-Request-ID: req-abc123
X-Response-Time: 45ms
X-Server: api-prod-01

Trace Context Propagation

Gunakan standar W3C Trace Context untuk sistem terdistribusi:

W3C Trace Context
// Request mencakup trace context
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
tracestate: dd=s:0
// Trace ID: 4bf92f3577b34da6a3ce929d0e0e4736
// Span ID: 00f067aa0ba902b7
// Sampled: true (01)

SLA Monitoring

Service Level Objectives

Plan	Uptime SLA	Response Time	Support
Free	99%	Best effort	Community
Trader	99.5%	<200ms p95	Email
Pro	99.95%	<100ms p95	Priority
Enterprise	99.99%	<50ms p95	Dedicated

SLA Credits

Jika uptime turun di bawah SLA, terima kredit layanan:

99.0% - 99.5%: 10% kredit bulanan
95.0% - 99.0%: 25% kredit bulanan
< 95.0%: 100% kredit bulanan

Monitoring Dashboards

Built-in Dashboard

Akses dashboard performa di: https://status.smartmoney.io

Custom Dashboard Setup

Prometheus Query
// Query tingkat request API
rate(api_requests_total[5m])
// Query tingkat kesalahan
rate(api_requests_total{status=~"5.."}[5m])
// Query persentil latensi
histogram_quantile(0.95, api_request_duration_ms)

Monitoring Tool Integration

Supported Platforms

Tool	Integration	Features
Prometheus	Native /metrics endpoint	Metrics scraping
Grafana	Datasource plugin	Custom dashboards
Datadog	API integration	APM tracing
New Relic	Agent integration	Full observability
PagerDuty	Webhook alerts	Incident management

Monitoring Best Practices

1. Monitor Key Metrics

Fokus pada metrik yang langsung memengaruhi bisnis Anda: uptime, latensi, tingkat kesalahan.

2. Set Appropriate Alerts

Alert pada gejala, bukan hanya ambang batas. Arahkan alert berdasarkan tingkat keparahan.

3. Use Request IDs

Selalu korelasikan request dengan ID unik untuk pelacakan end-to-end.

4. Implement Distributed Tracing

Gunakan W3C Trace Context untuk visibilitas di seluruh microservices.

5. Regular Alerting Tests

Uji saluran alert bulanan untuk memastikan eskalasi berfungsi.

6. Document Alert Response

Buat runbook untuk alert umum dengan langkah-langkah penyelesaian.

Ensure 99.9% Uptime

Monitor Smart Money API dengan pemeriksaan kesehatan, metrik, dan alerting yang komprehensif. Pertahankan kepatuhan SLA dengan alat observabilitas bawaan.

Get Started

Paket Pro dan Enterprise mencakup dukungan khusus dan pemantauan SLA.