Tartalomjegyzék

Áttekintés Állapotellenőrzések Metrikák és monitorozás Riasztások beállítása Kérésnaplózás Elosztott nyomkövetés SLA monitorozás Irányítópultok Monitorozási eszközök Ajánlott eljárások

API dokumentáció

API monitorozás, metrikák és állapotellenőrzések

A Smart Money API átfogó állapotellenőrzésekkel, teljesítménymetrikákkal és riasztásokkal figyelhető. Kövesse az üzemidőt, a késleltetést, a hibák arányát és az SLA betartását.

Közzétéve: 2026. március 21. • 13 perc olvasás • Műveletek

Monitorozás áttekintése

A Smart Money API átfogó monitorozási lehetőségeket kínál a szolgáltatás állapotának, teljesítményének és megbízhatóságának nyomon követéséhez. Alkalmazza ezeket a monitorozási stratégiákat a problémák korai észleléséhez és a magas üzemidő fenntartásához.

A monitorozás három szintje:

Állapotellenőrzések — Végpont elérhetősége és alapvető funkcionalitás
Metrikák — Teljesítményadatok (késleltetés, átviteli sebesség, hibák aránya)
Naplózás — Kérés/válasz részletek hibakereséshez és auditáláshoz

Célmetrikák: 99,9% üzemidő, <100ms p95 késleltetés, <0,1% hibaráta, <5 másodperc átlagos észlelési idő.

Állapotellenőrzések

API állapot végpont

Állapotellenőrzés
// Egyszerű életjelellenőrzés (nincs hitelesítés szükséges)
GET /health
// Válasz
HTTP/1.1 200 OK
{
 "status": "healthy",
 "timestamp": 1709980800000,
 "uptime": 99.95
}

Részletes állapotjelentés

Részletes állapot
// Részletes állapot komponens egészségügyi állapotával
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
  }
}

Szerezze meg API kulcsát 30 másodperc alatt

Készen áll a fejlesztésre? Szerezzen egy ingyenes API kulcsot (100 hívás/nap, kártya nélkül), és kezdjen élő bálna-, finanszírozási és láncon lévő adatokat lekérni.

Szerezze meg API kulcsát →

Metrikák és monitorozás

Követendő kulcsmetrikák

Metrika	Cél	Riasztási küszöb
Üzemidő	99.9%	<99.5%
P95 késleltetés	<100ms	>500ms
Hibaráta	<0.1%	>1%
Kérések/másodperc	Változó	Közeledik a limithoz
Gyorsítótár találati arány	>70%	<50%

Metrikák API végpont

Metrikák lekérdezése
// API metrikák lekérése monitorozáshoz
GET /v1/metrics?period=1h
  -H "Authorization: Bearer token"
// Metrikák visszaadása Prometheus formátumban
# HELP api_requests_total Összes API kérés
# TYPE api_requests_total counter
api_requests_total{method="GET",status="200"} 4502
api_requests_total{method="GET",status="429"} 12

Riasztások beállítása

Webhook riasztások

Riasztás létrehozása
POST /v1/alerts
  -H "Authorization: Bearer token"
  -d '{
 "name": "Magas hibaráta",
 "condition": "error_rate > 0.01",
 "webhook_url": "https://hooks.slack.com/...",
 "severity": "high"
  }'

Riasztás típusok

Üzemidő riasztás — API nem elérhető 5+ percig
Késleltetés riasztás — P95 késleltetés meghaladja a küszöbértéket
Hibaráta riasztás — Hibaráta 1% felett
Díjlimit riasztás — Közeledik a díjlimithoz
Adatfrissesség riasztás — Adat a küszöbértéknél régebbi

Kérésnaplózás

Naplózási szintek

Napló példa
// Tipikus API kérésnapló bejegyzés
{
 "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
}

Strukturált naplózás

Minden napló strukturált JSON formátumban van az egyszerű elemzéshez:

Időbélyeg ISO 8601 formátumban
Kérés azonosítója nyomkövetéshez
HTTP metódus és elérési út
Válasz állapota és késleltetés
Felhasználói azonosító és API kulcs ujjlenyomata
Hibaüzenetek, ha alkalmazható

Elosztott nyomkövetés

Kérés azonosító nyomon követése

Nyomkövetési fejlécek
// Minden kérés tartalmaz nyomkövetési fejléceket
curl -H "X-Request-ID: req-abc123" \
  https://api.smartmoneyapi.com/v1/whales
// A válasz tartalmazza ugyanazt az azonosítót
X-Request-ID: req-abc123
X-Response-Time: 45ms
X-Server: api-prod-01

Nyomkövetési kontextus propagálás

Használja a W3C Trace Context szabványt elosztott rendszerekhez:

W3C Trace Context
// A kérés tartalmazza a nyomkövetési kontextust
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
tracestate: dd=s:0
// Nyomkövetési azonosító: 4bf92f3577b34da6a3ce929d0e0e4736
// Span azonosító: 00f067aa0ba902b7
// Mintavételezve: true (01)

SLA Monitorozás

Szolgáltatási szintű célok

Csomag	Üzemidő SLA	Válaszidő	Támogatás
Ingyenes	99%	Legjobb erőfeszítés	Közösség
Kereskedő	99.5%	<200ms p95	E-mail
Pro	99.95%	<100ms p95	Prioritás
Vállalati	99.99%	<50ms p95	Dedikált

SLA jóváírások

Ha az üzemidő az SLA alá esik, szolgáltatási jóváírásokat kap:

99.0% - 99.5%: 10% havi jóváírás
95.0% - 99.0%: 25% havi jóváírás
< 95.0%: 100% havi jóváírás

Monitorozási irányítópultok

Beépített irányítópult

Hozzáférés a teljesítmény irányítópulthoz: https://status.smartmoney.io

Egyedi irányítópult beállítása

Prometheus lekérdezés
// API kérések arányának lekérdezése
rate(api_requests_total[5m])
// Hibák arányának lekérdezése
rate(api_requests_total{status=~"5.."}[5m])
// Késleltetés percentilis lekérdezése
histogram_quantile(0.95, api_request_duration_ms)

Monitorozási eszköz integráció

Támogatott platformok

Eszköz	Integráció	Funkciók
Prometheus	Natív /metrics végpont	Metrikák gyűjtése
Grafana	Adatforrás plugin	Egyedi irányítópultok
Datadog	API integráció	APM nyomkövetés
New Relic	Ügynök integráció	Teljes megfigyelhetőség
PagerDuty	Webhook riasztások	Incidens kezelés

Monitorozási ajánlott eljárások

1. Kulcsmetrikák monitorozása

Fókuszáljon az üzletet közvetlenül érintő metrikákra: üzemidő, késleltetés, hibaráta.

2. Megfelelő riasztások beállítása

Riasztás a tünetekre, ne csak a küszöbértékekre. Riasztások irányítása súlyosság szerint.

3. Kérés azonosítók használata

Mindig korrelálja a kéréseket egyedi azonosítókkal végpontok közötti nyomkövetéshez.

4. Elosztott nyomkövetés implementálása

Használja a W3C Trace Context-et a mikroservizek közötti láthatóságért.

5. Rendszeres riasztási tesztek

Tesztelje a riasztási csatornákat havonta, hogy biztosítsa az eszkaláció működését.

6. Riasztási válasz dokumentálása

Készítsen runbookokat a gyakori riasztásokhoz a megoldási lépésekkel.

Biztosítson 99,9%-os üzemidőt

Figyelje a Smart Money API-t átfogó állapotellenőrzésekkel, metrikákkal és riasztásokkal. Tartsa be az SLA-t a beépített megfigyelhetőségi eszközökkel.

Kezdje el

A Pro és Enterprise csomagok dedikált támogatást és SLA monitorozást tartalmaznak.