Inhaltsverzeichnis

Übersicht Health Checks Metriken & Überwachung Alarmierung einrichten Anfrageprotokollierung Verteilte Ablaufverfolgung SLA-Überwachung Dashboards Überwachungstools Beste Praktiken

API-Dokumentation

API-Überwachung, Metriken und Health Checks

Überwachen Sie die Smart Money API mit umfassenden Health Checks, Leistungsmetriken und Alarmierung. Verfolgen Sie Verfügbarkeit, Latenz, Fehlerraten und SLA-Konformität.

Veröffentlicht am 21. März 2026 • 13 Min. Lesezeit • Betrieb

Überwachungsübersicht

Die Smart Money API bietet umfassende Überwachungsfunktionen, um die Dienstgesundheit, Leistung und Zuverlässigkeit zu verfolgen. Implementieren Sie diese Überwachungsstrategien, um Probleme frühzeitig zu erkennen und eine hohe Verfügbarkeit zu gewährleisten.

Drei Ebenen der Überwachung:

Health Checks — Endpunktverfügbarkeit und grundlegende Funktionalität
Metriken — Leistungsdaten (Latenz, Durchsatz, Fehlerraten)
Protokollierung — Anfrage-/Antwortdetails für Debugging und Audit

Zielmetriken: 99,9 % Verfügbarkeit, <100 ms p95-Latenz, <0,1 % Fehlerrate, <5 Sekunden mittlere Erkennungszeit.

Health Checks

API-Health-Endpunkt

Health Check
// Einfache Liveness-Prüfung (keine Authentifizierung erforderlich)
GET /health
// Antwort
HTTP/1.1 200 OK
{
 "status": "healthy",
 "timestamp": 1709980800000,
 "uptime": 99.95
}

Detaillierter Gesundheitsstatus

Detaillierter Health Check
// Detaillierter Status mit Komponentengesundheit
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
  }
}

Holen Sie sich Ihren API-Schlüssel in 30 Sekunden

Bereit zu entwickeln? Holen Sie sich einen kostenlosen API-Schlüssel (200 Aufrufe/Tag, keine Karte) und beginnen Sie mit dem Abruf von Live-Daten zu Walen, Finanzierungen und On-Chain-Daten.

Holen Sie sich Ihren API-Schlüssel →

Metriken & Überwachung

Wichtige Metriken zur Überwachung

Metrik	Ziel	Alarmschwelle
Verfügbarkeit	99.9%	<99.5%
P95-Latenz	<100ms	>500ms
Fehlerrate	<0.1%	>1%
Anfragen/Sek.	Variiert	Annäherung an Limit
Cache-Trefferquote	>70%	<50%

Metriken-API-Endpunkt

Metrikenabfrage
// API-Metriken für die Überwachung abrufen
GET /v1/metrics?period=1h
  -H "Authorization: Bearer token"
// Gibt Metriken im Prometheus-Format zurück
# HELP api_requests_total Gesamte API-Anfragen
# TYPE api_requests_total counter
api_requests_total{method="GET",status="200"} 4502
api_requests_total{method="GET",status="429"} 12

Alarmierung einrichten

Webhook-Alarme

Alarm erstellen
POST /v1/alerts
  -H "Authorization: Bearer token"
  -d '{
 "name": "Hohe Fehlerrate",
 "condition": "error_rate > 0.01",
 "webhook_url": "https://hooks.slack.com/...",
 "severity": "high"
  }'

Alarmtypen

Verfügbarkeitsalarm — API für mehr als 5 Minuten nicht verfügbar
Latenzalarm — P95-Latenz überschreitet Schwellenwert
Fehlerrate-Alarm — Fehlerrate über 1 %
Ratenlimit-Alarm — Annäherung an Ratenlimit
Datenaktualitätsalarm — Daten älter als Schwellenwert

Anfrageprotokollierung

Protokollierungsstufen

Protokollbeispiel
// Typischer API-Anfrageprotokolleintrag
{
 "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
}

Strukturierte Protokollierung

Alle Protokolle sind strukturierte JSON-Daten zur einfachen Analyse:

Zeitstempel im ISO-8601-Format
Anfrage-ID zur Nachverfolgung
HTTP-Methode und Pfad
Antwortstatus und Latenz
Benutzer-ID und API-Schlüssel-Fingerabdruck
Fehlermeldungen (falls zutreffend)

Verteilte Ablaufverfolgung

Anfrage-ID-Nachverfolgung

Ablaufverfolgungs-Header
// Alle Anfragen enthalten Ablaufverfolgungs-Header
curl -H "X-Request-ID: req-abc123" \
  https://api.smartmoneyapi.com/v1/whales
// Antwort enthält dieselbe ID
X-Request-ID: req-abc123
X-Response-Time: 45ms
X-Server: api-prod-01

Trace-Kontext-Propagierung

Nutzen Sie den W3C Trace Context-Standard für verteilte Systeme:

W3C Trace Context
// Anfrage enthält Trace-Kontext
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
tracestate: dd=s:0
// Trace-ID: 4bf92f3577b34da6a3ce929d0e0e4736
// Span-ID: 00f067aa0ba902b7
// Sampled: true (01)

SLA-Überwachung

Service-Level-Ziele

Plan	Uptime-SLA	Antwortzeit	Support
Kostenlos	99%	Beste Bemühungen	Community
Trader	99.5%	<200ms p95	E-Mail
Pro	99.95%	<100ms p95	Priorität
Enterprise	99.99%	<50ms p95	Dediziert

SLA-Gutschriften

Bei Unterschreitung der Uptime-SLA erhalten Sie Service-Gutschriften:

99.0% - 99.5%: 10% monatliche Gutschrift
95.0% - 99.0%: 25% monatliche Gutschrift
< 95.0%: 100% monatliche Gutschrift

Überwachungs-Dashboards

Integriertes Dashboard

Zugriff auf das Leistungs-Dashboard unter: https://status.smartmoney.io

Einrichtung benutzerdefinierter Dashboards

Prometheus-Abfrage
// Abfrage der API-Anfrage-Rate
rate(api_requests_total[5m])
// Abfrage der Fehlerrate
rate(api_requests_total{status=~"5.."}[5m])
// Abfrage des Latenz-Perzentils
histogram_quantile(0.95, api_request_duration_ms)

Integration von Überwachungstools

Unterstützte Plattformen

Tool	Integration	Funktionen
Prometheus	Native /metrics-Endpunkt	Metriken-Scraping
Grafana	Datenquellen-Plugin	Benutzerdefinierte Dashboards
Datadog	API-Integration	APM-Ablaufverfolgung
New Relic	Agenten-Integration	Volle Beobachtbarkeit
PagerDuty	Webhook-Alarme	Incident-Management

Bewährte Überwachungspraktiken

1. Überwachen Sie wichtige Metriken

Konzentrieren Sie sich auf Metriken, die Ihr Geschäft direkt beeinflussen: Uptime, Latenz, Fehlerrate.

2. Richten Sie geeignete Alarme ein

Alarmieren Sie bei Symptomen, nicht nur bei Schwellenwerten. Leiten Sie Alarme nach Schweregrad weiter.

3. Verwenden Sie Anfrage-IDs

Korrelieren Sie Anfragen immer mit eindeutigen IDs für eine End-to-End-Nachverfolgung.

4. Implementieren Sie verteilte Ablaufverfolgung

Nutzen Sie W3C Trace Context für Sichtbarkeit über Microservices hinweg.

5. Regelmäßige Alarmtests

Testen Sie Alarmkanäle monatlich, um die Eskalation sicherzustellen.

6. Dokumentieren Sie die Alarmreaktion

Erstellen Sie Runbooks für häufige Alarme mit Lösungs-Schritten.

Sicherstellen Sie 99,9% Uptime

Überwachen Sie die Smart Money API mit umfassenden Gesundheitsprüfungen, Metriken und Alarmen. Halten Sie SLA-Konformität mit integrierten Beobachtbarkeitstools ein.

Loslegen

Pro- und Enterprise-Pläne beinhalten dedizierten Support und SLA-Überwachung.