Innehållsförteckning

Översikt Hälsokontroller Mätvärden & Övervakning Konfigurering av aviseringar Begärandeloggning Distribuerad spårning SLA-övervakning Instrumentpaneler Övervakningsverktyg Bästa praxis

API-dokumentation

API-övervakning, mätvärden och hälsokontroller

Övervaka Smart Money API med omfattande hälsokontroller, prestandamätvärden och aviseringar. Spåra drifttid, svarstid, felhastighet och SLA-efterlevnad.

Publicerad 21 mars 2026 • 13 min läsning • Drift

Översikt över övervakning

Smart Money API erbjuder omfattande övervakningsfunktioner för att spåra tjänstehälsa, prestanda och tillförlitlighet. Implementera dessa övervakningsstrategier för att upptäcka problem tidigt och upprätthålla hög drifttid.

Tre lager av övervakning:

Hälsokontroller — Endpoint-tillgänglighet och grundläggande funktionalitet
Mätvärden — Prestandadata (svarstid, genomströmning, felhastighet)
Loggning — Begäran/svar-detaljer för felsökning och revision

Målmätvärden: 99.9% drifttid, <100ms p95-svarstid, <0.1% felhastighet, <5 sekunder genomsnittlig tid till upptäckt.

Hälsokontroller

API-hälsa-endpoint

Hälsokontroll
// Enkel livskontroll (ingen autentisering krävs)
GET /health
// Svar
HTTP/1.1 200 OK
{
 "status": "healthy",
 "timestamp": 1709980800000,
 "uptime": 99.95
}

Detaljerad hälsostatus

Detaljerad hälsa
// Detaljerad status med komponenthälsa
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
  }
}

Få din API-nyckel på 30 sekunder

Redo att bygga? Hämta en gratis API-nyckel (200 anrop/dag, inget kort behövs) och börja hämta live-data om val, finansiering och on-chain-data.

Få din API-nyckel →

Mätvärden & Övervakning

Nyckelmätvärden att spåra

Mätvärde	Mål	Aviseringsgräns
Drifttid	99.9%	<99.5%
P95-svarstid	<100ms	>500ms
Felhastighet	<0.1%	>1%
Förfrågningar/sek	Varierar	Närmar sig gräns
Cacheträffsäkerhet	>70%	<50%

Mätvärdes-API-endpoint

Mätvärdesfråga
// Hämta API-mätvärden för övervakning
GET /v1/metrics?period=1h
  -H "Authorization: Bearer token"
// Returnerar mätvärden i Prometheus-format
# HELP api_requests_total Totalt antal API-förfrågningar
# TYPE api_requests_total counter
api_requests_total{method="GET",status="200"} 4502
api_requests_total{method="GET",status="429"} 12

Konfigurering av aviseringar

Webhook-aviseringar

Skapa avisering
POST /v1/alerts
  -H "Authorization: Bearer token"
  -d '{
 "name": "Hög felhastighet",
 "condition": "error_rate > 0.01",
 "webhook_url": "https://hooks.slack.com/...",
 "severity": "high"
  }'

Aviseringsstyper

Drifttidsavisering — API otillgängligt i 5+ minuter
Svarstidsavisering — P95-svarstid överskrider tröskelvärde
Felhastighetsavisering — Felhastighet över 1%
Begränsningsavisering — Närmar sig begränsning
Datafärskhetsavisering — Data äldre än tröskelvärde

Begärandeloggning

Loggningsnivåer

Loggexempel
// Typisk API-begäran loggpost
{
 "timestamp": "2026-03-21T14:00:00Z",
 "request_id": "req_abc123def456",
 metod: GET,
 sökväg: /v1/whales/btc,
 status: 200,
 varaktighet_ms: 45,
 användar_id: acct_12345
}

Strukturerad loggning

Alla loggar är strukturerade JSON för enkel analys:

Tidsstämpel i ISO 8601-format
Förfrågnings-ID för spårning
HTTP-metod och sökväg
Svarsstatus och svarstid
Användar-ID och API-nyckels fingeravtryck
Felmeddelanden om tillämpligt

Distribuerad spårning

Spårning av förfrågnings-ID

Spårningshuvuden
// Alla förfrågningar inkluderar spårningshuvuden
curl -H "X-Request-ID: req-abc123" \
  https://api.smartmoneyapi.com/v1/whales
// Svaret inkluderar samma ID
X-Request-ID: req-abc123
X-Response-Time: 45ms
X-Server: api-prod-01

Spridning av spårningskontext

Använd W3C Trace Context-standard för distribuerade system:

W3C Trace Context
// Förfrågan inkluderar spårningskontext
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
tracestate: dd=s:0
// Spårnings-ID: 4bf92f3577b34da6a3ce929d0e0e4736
// Span-ID: 00f067aa0ba902b7
// Samplad: true (01)

SLA-övervakning

Service Level Objectives

Plan	Upptidsserviceavtal	Svarstid	Support
Gratis	99%	Bästa möjliga insats	Community
Trader	99.5%	<200ms p95	E-post
Pro	99.95%	<100ms p95	Prioriterad
Enterprise	99.99%	<50ms p95	Dedikerad

SLA-krediter

Om upptiden faller under SLA, få servicekrediter:

99.0% - 99.5%: 10% månatlig kredit
95.0% - 99.0%: 25% månatlig kredit
< 95.0%: 100% månatlig kredit

Övervakningsinstrumentpaneler

Inbyggd instrumentpanel

Få tillgång till prestandainstrumentpanelen på: https://status.smartmoney.io

Anpassad instrumentpanelsinställning

Prometheus-förfrågan
// Fråga API-förfrågningsfrekvens
rate(api_requests_total[5m])
// Fråga felfrekvens
rate(api_requests_total{status=~"5.."}[5m])
// Fråga latenspercentil
histogram_quantile(0.95, api_request_duration_ms)

Integration av övervakningsverktyg

Plattformar som stöds

Verktyg	Integration	Funktioner
Prometheus	Inbyggd /metrics-slutpunkt	Skrapning av mätvärden
Grafana	Datakällplugin	Anpassade instrumentpaneler
Datadog	API-integration	APM-spårning
New Relic	Agentintegration	Fullständig observerbarhet
PagerDuty	Webhook-varningar	Incidenthantering

Bästa praxis för övervakning

1. Övervaka nyckelmått

Fokusera på mått som direkt påverkar din verksamhet: upptid, latens, felfrekvens.

2. Ställ in lämpliga varningar

Varna vid symptom, inte bara tröskelvärden. Dirigera varningar efter allvarlighetsgrad.

3. Använd förfrågnings-ID:n

Korrelera alltid förfrågningar med unika ID:n för spårning från slut till slut.

4. Implementera distribuerad spårning

Använd W3C Trace Context för synlighet över mikrotjänster.

5. Regelbundna varningstester

Testa varningskanaler månadsvis för att säkerställa att eskalering fungerar.

6. Dokumentera varningssvar

Skapa handböcker för vanliga varningar med lösningssteg.

Säkerställ 99,9 % upptid

Övervaka Smart Money API med omfattande hälsokontroller, mätvärden och varningar. Upprätthåll SLA-efterlevnad med inbyggda observerbarhetsverktyg.

Kom igång

Pro- och Enterprise-planer inkluderar dedikerad support och SLA-övervakning.