Obsah

Přehled Kontroly Stavu Metriky & Monitoring Nastavení Upozornění Logování Požadavků Distribuované Sledování SLA Monitoring Řídicí Panely Nástroje pro Monitoring Doporučené Postupy

Dokumentace API

API Monitoring, Metriky a Kontroly Stavu

Sledujte Smart Money API pomocí komplexních kontrol stavu, výkonnostních metrik a upozornění. Monitorujte dostupnost, latenci, míru chyb a dodržování SLA.

Publikováno 21. března 2026 • 13 minut čtení • Operace

Přehled Monitoringu

Smart Money API poskytuje komplexní monitorovací schopnosti pro sledování stavu služby, výkonu a spolehlivosti. Implementujte tyto monitorovací strategie pro včasné odhalení problémů a udržení vysoké dostupnosti.

Tři vrstvy monitoringu:

Kontroly Stavu — Dostupnost koncových bodů a základní funkčnost
Metriky — Výkonnostní data (latence, propustnost, míra chyb)
Logování — Detaily požadavků/odpovědí pro ladění a audit

Cílové Metriky: 99.9 % dostupnost, <100ms p95 latence, <0.1 % míra chyb, <5 sekund průměrná doba detekce.

Kontroly Stavu

Koncový Bod Stavu API

Kontrola Stavu
// Jednoduchá kontrola živosti (bez nutnosti autentizace)
GET /health
// Odpověď
HTTP/1.1 200 OK
{
 "status": "healthy",
 "timestamp": 1709980800000,
 "uptime": 99.95
}

Podrobný Stav Zdraví

Podrobný Stav
// Podrobný stav se zdravím komponent
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
  }
}

Získejte svůj API klíč za 30 sekund

Připraveni stavět? Získejte zdarma API klíč (200 volání/den, bez karty) a začněte stahovat živá data o velrybách, financování a on-chain transakcích.

Získejte svůj API klíč →

Metriky & Monitoring

Klíčové Metriky ke Sledování

Metrika	Cíl	Prahová Hodnota Upozornění
Dostupnost	99.9%	<99.5%
P95 Latence	<100ms	>500ms
Míra Chyb	<0.1%	>1%
Požadavky za sekundu	Různé	Blíží se limitu
Úspěšnost Cache	>70%	<50%

Koncový Bod Metrik API

Dotaz na Metriky
// Získání metrik API pro monitoring
GET /v1/metrics?period=1h
  -H "Authorization: Bearer token"
// Vrací metriky ve formátu Prometheus
# HELP api_requests_total Celkový počet API požadavků
# TYPE api_requests_total counter
api_requests_total{method="GET",status="200"} 4502
api_requests_total{method="GET",status="429"} 12

Nastavení Upozornění

Upozornění přes Webhook

Vytvořit Upozornění
POST /v1/alerts
  -H "Authorization: Bearer token"
  -d '{
 "name": "Vysoká Míra Chyb",
 "condition": "error_rate > 0.01",
 "webhook_url": "https://hooks.slack.com/...",
 "severity": "high"
  }'

Typy Upozornění

Upozornění na Dostupnost — API nedostupné déle než 5 minut
Upozornění na Latenci — P95 latence překročila prahovou hodnotu
Upozornění na Míru Chyb — Míra chyb nad 1 %
Upozornění na Limit Rychlosti — Blíží se limitu rychlosti
Upozornění na Čerstvost Dat — Data starší než prahová hodnota

Logování Požadavků

Úrovně Logování

Příklad Logu
// Typická položka logu API požadavku
{
 "timestamp": "2026-03-21T14:00:00Z",
 "request_id": "req_abc123def456",
 metoda: GET,
 cesta: /v1/whales/btc,
 stav: 200,
 trvání_ms: 45,
 uživatelské ID: acct_12345
}

Strukturované logování

Všechny logy jsou ve strukturovaném JSON formátu pro snadné parsování a analýzu:

Časové razítko ve formátu ISO 8601
ID požadavku pro trasování
HTTP metoda a cesta
Stav odpovědi a latence
Uživatelské ID a otisk API klíče
Chybové zprávy, pokud jsou k dispozici

Distribuované trasování

Sledování ID požadavku

Trasovací hlavičky
// Všechny požadavky obsahují trasovací hlavičky
curl -H "X-Request-ID: req-abc123" \
  https://api.smartmoneyapi.com/v1/whales
// Odpověď obsahuje stejné ID
X-Request-ID: req-abc123
X-Response-Time: 45ms
X-Server: api-prod-01

Propagace kontextu trasování

Použijte standard W3C Trace Context pro distribuované systémy:

W3C Trace Context
// Požadavek obsahuje kontext trasování
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
tracestate: dd=s:0
// ID trasování: 4bf92f3577b34da6a3ce929d0e0e4736
// ID rozsahu: 00f067aa0ba902b7
// Vzorkováno: true (01)

SLA Monitoring

Cíle úrovně služeb

Plán	Uptime SLA	Doba odezvy	Podpora
Zdarma	99%	Nejlepší úsilí	Komunita
Trader	99.5%	<200ms p95	E-mail
Pro	99.95%	<100ms p95	Priorita
Enterprise	99.99%	<50ms p95	Vyhrazeno

SLA Kredity

Pokud uptime klesne pod SLA, obdržíte servisní kredity:

99.0% - 99.5%: 10% měsíční kredit
95.0% - 99.0%: 25% měsíční kredit
< 95.0%: 100% měsíční kredit

Monitorovací dashboardy

Vestavěný dashboard

Přístup k výkonnostnímu dashboardu na: https://status.smartmoney.io

Nastavení vlastního dashboardu

Prometheus dotaz
// Dotaz na míru požadavků API
rate(api_requests_total[5m])
// Dotaz na míru chyb
rate(api_requests_total{status=~"5.."}[5m])
// Dotaz na percentil latence
histogram_quantile(0.95, api_request_duration_ms)

Integrace monitorovacích nástrojů

Podporované platformy

Nástroj	Integrace	Funkce
Prometheus	Nativní /metrics endpoint	Sběr metrik
Grafana	Plugin zdroje dat	Vlastní dashboardy
Datadog	API integrace	APM trasování
New Relic	Integrace agenta	Úplná pozorovatelnost
PagerDuty	Webhook upozornění	Správa incidentů

Osvědčené postupy monitorování

1. Sledujte klíčové metriky

Zaměřte se na metriky, které přímo ovlivňují váš byznys: uptime, latenci, míru chyb.

2. Nastavte vhodná upozornění

Upozorňujte na symptomy, nejen na prahové hodnoty. Směrujte upozornění podle závažnosti.

3. Používejte ID požadavků

Vždy korelujte požadavky s unikátními ID pro end-to-end trasování.

4. Implementujte distribuované trasování

Použijte W3C Trace Context pro viditelnost napříč mikroslužbami.

5. Pravidelné testování upozornění

Testujte kanály upozornění měsíčně, abyste zajistili fungování eskalace.

6. Dokumentujte reakci na upozornění

Vytvořte runbooky pro běžná upozornění s kroky k řešení.

Zajistěte 99.9% Uptime

Monitorujte Smart Money API s komplexními kontrolami zdraví, metrikami a upozorněními. Udržujte dodržování SLA s vestavěnými nástroji pro pozorovatelnost.

Začněte

Pro a Enterprise plány zahrnují vyhrazenou podporu a SLA monitoring.