Jadual Kandungan

Gambaran Keseluruhan Semakan Kesihatan Metrik & Pemantauan Persediaan Amaran Log Permintaan Penjejakan Teragih Pemantauan SLA Papan Pemuka Alat Pemantauan Amalan Terbaik

Dokumentasi API

Pemantauan API, Metrik, dan Semakan Kesihatan

Pantau Smart Money API dengan semakan kesihatan menyeluruh, metrik prestasi, dan amaran. Jejak masa aktif, kependaman, kadar ralat, dan pematuhan SLA.

Diterbitkan pada 21 Mac 2026 • 13 minit baca • Operasi

Gambaran Keseluruhan Pemantauan

Smart Money API menyediakan keupayaan pemantauan menyeluruh untuk menjejaki kesihatan perkhidmatan, prestasi, dan kebolehpercayaan. Laksanakan strategi pemantauan ini untuk mengesan isu awal dan mengekalkan masa aktif yang tinggi.

Tiga lapisan pemantauan:

Semakan Kesihatan — Ketersediaan dan fungsi asas endpoint
Metrik — Data prestasi (kependaman, kadar aliran, kadar ralat)
Log — Butiran permintaan/tindak balas untuk penyahpepijatan dan audit

Metrik Sasaran: 99.9% masa aktif, <100ms p95 kependaman, <0.1% kadar ralat, <5 saat purata masa untuk mengesan.

Semakan Kesihatan

Endpoint Kesihatan API

Semakan Kesihatan
// Semakan kesihatan mudah (tiada pengesahan diperlukan)
GET /health
// Tindak balas
HTTP/1.1 200 OK
{
 "status": "sihat",
 "timestamp": 1709980800000,
 "masa aktif": 99.95
}

Status Kesihatan Terperinci

Kesihatan Terperinci
// Status terperinci dengan kesihatan komponen
GET /v1/status
  -H "Authorization: Bearer token"
{
 "status": "beroperasi",
 "components": {
 "api": "sihat",
 "database": "sihat",
 "cache": "sihat",
 "exchanges": "sihat"
  },
 "metrics": {
 "p95_latency_ms": 85,
 "error_rate": 0.0012,
 "uptime_percent": 99.95
  }
}

Dapatkan kunci API anda dalam 30 saat

Sedia untuk membina? Dapatkan kunci API percuma (100 panggilan/hari, tiada kad) dan mula menarik data paus, pembiayaan dan data on-chain secara langsung.

Dapatkan kunci API anda →

Metrik & Pemantauan

Metrik Utama untuk Dijejaki

Metrik	Sasaran	Ambang Amaran
Masa Aktif	99.9%	<99.5%
Kependaman P95	<100ms	>500ms
Kadar Ralat	<0.1%	>1%
Permintaan/saat	Berbeza-beza	Menghampiri had
Kadar Hit Cache	>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 Jumlah permintaan API
# TYPE api_requests_total counter
api_requests_total{method="GET",status="200"} 4502
api_requests_total{method="GET",status="429"} 12

Persediaan Amaran

Amaran Webhook

Buat Amaran
POST /v1/alerts
  -H "Authorization: Bearer token"
  -d '{
 "name": "Kadar Ralat Tinggi",
 "condition": "error_rate > 0.01",
 "webhook_url": "https://hooks.slack.com/...",
 "severity": "tinggi"
  }'

Jenis Amaran

Amaran Masa Aktif — API tidak tersedia selama 5+ minit
Amaran Kependaman — Kependaman P95 melebihi ambang
Amaran Kadar Ralat — Kadar ralat melebihi 1%
Amaran Had Kadar — Menghampiri had kadar
Amaran Kesegaran Data — Data lebih lama daripada ambang

Log Permintaan

Tahap Log

Contoh Log
// Entri log permintaan API biasa
{
 "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
}

Pengekodan Berstruktur

Semua log berstruktur dalam JSON untuk pemprosesan dan analisis mudah:

Timestamp dalam format ISO 8601
ID Permintaan untuk penjejakan
Kaedah HTTP dan laluan
Status respons dan masa tindak balas
ID Pengguna dan cap jari kunci API
Mesej ralat jika ada

Penjejakan Teragih

Penjejakan ID Permintaan

Penjejakan Header
// Semua permintaan termasuk header penjejakan
curl -H "X-Request-ID: req-abc123" \
  https://api.smartmoneyapi.com/v1/whales
// Respons termasuk ID yang sama
X-Request-ID: req-abc123
X-Response-Time: 45ms
X-Server: api-prod-01

Penyebaran Konteks Jejak

Gunakan piawai W3C Trace Context untuk sistem teragih:

W3C Trace Context
// Permintaan termasuk konteks jejak
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
tracestate: dd=s:0
// ID Jejak: 4bf92f3577b34da6a3ce929d0e0e4736
// ID Rentang: 00f067aa0ba902b7
// Disampel: benar (01)

Pemantauan SLA

Objektif Tahap Perkhidmatan

Pelan	SLA Masa Aktif	Masa Tindak Balas	Sokongan
Percuma	99%	Usaha terbaik	Komuniti
Peniaga	99.5%	<200ms p95	E-mel
Pro	99.95%	<100ms p95	Keutamaan
Enterprise	99.99%	<50ms p95	Dedikasi

Kredit SLA

Jika masa aktif jatuh di bawah SLA, terima kredit perkhidmatan:

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

Papan Pemuka Pemantauan

Papan Pemuka Terbina

Akses papan pemuka prestasi di: https://status.smartmoney.io

Pemasangan Papan Pemuka Tersuai

Kueri Prometheus
// Kueri kadar permintaan API
rate(api_requests_total[5m])
// Kueri kadar ralat
rate(api_requests_total{status=~"5.."}[5m])
// Kueri persentil masa tindak balas
histogram_quantile(0.95, api_request_duration_ms)

Integrasi Alat Pemantauan

Platform Disokong

Alat	Integrasi	Ciri
Prometheus	Natih /metrics endpoint	Pengikisan metrik
Grafana	Pemalam sumber data	Papan pemuka tersuai
Datadog	Integrasi API	Penjejakan APM
New Relic	Integrasi ejen	Pemerhatian penuh
PagerDuty	Amaran webhook	Pengurusan insiden

Amalan Terbaik Pemantauan

1. Pantau Metrik Utama

Fokus pada metrik yang memberi kesan langsung kepada perniagaan anda: masa aktif, masa tindak balas, kadar ralat.

2. Tetapkan Amaran Yang Sesuai

Amar pada gejala, bukan hanya ambang. Laluan amaran mengikut keparahan.

3. Gunakan ID Permintaan

Sentiasa hubungkan permintaan dengan ID unik untuk penjejakan hujung ke hujung.

4. Laksanakan Penjejakan Teragih

Gunakan W3C Trace Context untuk keterlihatan merentasi perkhidmatan mikro.

5. Ujian Amaran Berkala

Uji saluran amaran bulanan untuk memastikan eskalasi berfungsi.

6. Dokumen Tindak Balas Amaran

Buat buku panduan untuk amaran biasa dengan langkah penyelesaian.

Pastikan 99.9% Masa Aktif

Pantau Smart Money API dengan pemeriksaan kesihatan, metrik, dan amaran yang komprehensif. Patuhi SLA dengan alat pemerhatian terbina.

Mulakan

Pelan Pro dan Enterprise termasuk sokongan berdedikasi dan pemantauan SLA.