Cuprins

Prezentare generală Verificări de sănătate Metrici și monitorizare Configurare alerte Înregistrare cereri Tracing distribuit Monitorizare SLA Panouri de control Instrumente de monitorizare Bune practici

Documentație API

Monitorizare API, Metrici și Verificări de Sănătate

Monitorizați Smart Money API cu verificări de sănătate cuprinzătoare, metrici de performanță și alerte. Urmăriți timpul de funcționare, latența, ratele de eroare și conformitatea SLA.

Publicat pe 21 martie 2026 • 13 min de citit • Operațiuni

Prezentare generală a monitorizării

Smart Money API oferă capabilități cuprinzătoare de monitorizare pentru a urmări sănătatea serviciului, performanța și fiabilitatea. Implementați aceste strategii de monitorizare pentru a detecta problemele devreme și a menține un timp de funcționare ridicat.

Trei niveluri de monitorizare:

Verificări de sănătate — Disponibilitatea endpoint-ului și funcționalitatea de bază
Metrici — Date de performanță (latență, debit, rate de eroare)
Înregistrare — Detalii cerere/răspuns pentru depanare și audit

Metrici țintă: 99.9% timp de funcționare, <100ms latență p95, <0.1% rată de eroare, <5 secunde timp mediu de detectare.

Verificări de sănătate

Endpoint de sănătate API

Verificare de sănătate
// Verificare simplă de viață (nu este necesară autentificare)
GET /health
// Răspuns
HTTP/1.1 200 OK
{
 "status": "healthy",
 "timestamp": 1709980800000,
 "uptime": 99.95
}

Stare detaliată de sănătate

Sănătate detaliată
// Stare detaliată cu sănătatea componentelor
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
  }
}

Obțineți cheia dvs. API în 30 de secunde

Sunteți gata să construiți? Obțineți o cheie API gratuită (50 de apeluri/zi, fără card) și începeți să extrageți date live despre balene, finanțare și lanț.

Obțineți cheia dvs. API →

Metrici și monitorizare

Metrici cheie de urmărit

Metrică	Țintă	Prag de alertă
Timp de funcționare	99.9%	<99.5%
Latență P95	<100ms	>500ms
Rată de eroare	<0.1%	>1%
Cereri/sec	Variază	Apropiindu-se de limită
Rată de accesare cache	>70%	<50%

Endpoint API pentru metrici

Interogare metrici
// Obțineți metrici API pentru monitorizare
GET /v1/metrics?period=1h
  -H "Authorization: Bearer token"
// Returnează metrici în format Prometheus
# HELP api_requests_total Total cereri API
# TYPE api_requests_total counter
api_requests_total{method="GET",status="200"} 4502
api_requests_total{method="GET",status="429"} 12

Configurare alerte

Alerte Webhook

Creați alertă
POST /v1/alerts
  -H "Authorization: Bearer token"
  -d '{
 "name": "Rată ridicată de eroare",
 "condition": "error_rate > 0.01",
 "webhook_url": "https://hooks.slack.com/...",
 "severity": "high"
  }'

Tipuri de alerte

Alertă timp de funcționare — API indisponibil pentru 5+ minute
Alertă latență — Latența P95 depășește pragul
Alertă rată de eroare — Rata de eroare peste 1%
Alertă limită de rată — Apropiindu-se de limita de rată
Alertă proaspătățe date — Date mai vechi decât pragul

Înregistrare cereri

Niveluri de înregistrare

Exemplu de înregistrare
// Intrare tipică de înregistrare a cererii API
{
 "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
}

Înregistrare Structurată

Toate jurnalele sunt în format JSON structurat pentru o analiză și parsare ușoară:

Marcaj temporal în format ISO 8601
ID de solicitare pentru urmărire
Metodă HTTP și cale
Stare de răspuns și latență
ID utilizator și amprentă cheie API
Mesaje de eroare, dacă este cazul

Urmărire Distribuită

Urmărire ID Solicitare

Antete de Urmărire
// Toate solicitările includ antete de urmărire
curl -H "X-Request-ID: req-abc123" \
  https://api.smartmoneyapi.com/v1/whales
// Răspunsul include același ID
X-Request-ID: req-abc123
X-Response-Time: 45ms
X-Server: api-prod-01

Propagare Context de Urmărire

Utilizați standardul W3C Trace Context pentru sisteme distribuite:

W3C Trace Context
// Solicitarea include context de urmărire
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
tracestate: dd=s:0
// ID Urmărire: 4bf92f3577b34da6a3ce929d0e0e4736
// ID Interval: 00f067aa0ba902b7
// Eșantionat: true (01)

Monitorizare SLA

Obiective de Nivel de Serviciu

Plan	SLA Disponibilitate	Timp de Răspuns	Suport
Gratuit	99%	Eforturi maxime	Comunitate
Trader	99.5%	<200ms p95	Email
Pro	99.95%	<100ms p95	Prioritar
Enterprise	99.99%	<50ms p95	Dedicat

Credite SLA

Dacă disponibilitatea scade sub SLA, primiți credite de serviciu:

99.0% - 99.5%: 10% credit lunar
95.0% - 99.0%: 25% credit lunar
< 95.0%: 100% credit lunar

Panouri de Monitorizare

Panou Integrat

Accesați panoul de performanță la: https://status.smartmoney.io

Configurare Panou Personalizat

Interogare Prometheus
// Interogați rata de solicitări API
rate(api_requests_total[5m])
// Interogați rata de erori
rate(api_requests_total{status=~"5.."}[5m])
// Interogați percentila de latență
histogram_quantile(0.95, api_request_duration_ms)

Integrare Instrumente de Monitorizare

Platforme Suportate

Instrument	Integrare	Funcționalități
Prometheus	Endpoint nativ /metrics	Extragere metrici
Grafana	Plugin sursă de date	Panouri personalizate
Datadog	Integrare API	Urmărire APM
New Relic	Integrare agent	Observabilitate completă
PagerDuty	Alerte webhook	Gestionare incidente

Practici Recomandate de Monitorizare

1. Monitorizați Metrici Cheie

Concentrați-vă pe metricile care afectează direct afacerea: disponibilitate, latență, rata de erori.

2. Setări de Alerte Adecvate

Alertați pe simptome, nu doar pe praguri. Dirijați alertele după severitate.

3. Utilizați ID-uri de Solicitare

Corelați întotdeauna solicitările cu ID-uri unice pentru urmărire end-to-end.

4. Implementați Urmărire Distribuită

Utilizați W3C Trace Context pentru vizibilitate în microservicii.

5. Teste Periodice de Alertare

Testați canalele de alertă lunar pentru a vă asigura că escaladarea funcționează.

6. Documentați Răspunsul la Alerte

Creați ghiduri pentru alerte comune cu pași de rezolvare.

Asigurați 99.9% Disponibilitate

Monitorizați Smart Money API cu verificări de sănătate cuprinzătoare, metrici și alertare. Mențineți conformitatea SLA cu instrumente de observabilitate integrate.

Începeți

Planurile Pro și Enterprise includ suport dedicat și monitorizare SLA.