Inhoudsopgave

Overzicht Health Checks Metrieken & Monitoring Alertinstellingen Request Logging Distributed Tracing SLA Monitoring Dashboards Monitoring Tools Best Practices

API Documentatie

API Monitoring, Metrieken en Health Checks

Monitor Smart Money API met uitgebreide health checks, prestatiemetrieken en alerting. Houd uptime, latentie, foutpercentages en SLA-naleving bij.

Gepubliceerd op 21 maart 2026 • 13 min leestijd • Operations

Monitoring Overzicht

Smart Money API biedt uitgebreide monitoringmogelijkheden om de servicestatus, prestaties en betrouwbaarheid te volgen. Implementeer deze monitoringstrategieën om problemen vroegtijdig te detecteren en een hoge uptime te behouden.

Drie lagen van monitoring:

Health Checks — Endpointbeschikbaarheid en basisfunctionaliteit
Metrieken — Prestatiegegevens (latentie, doorvoer, foutpercentages)
Logging — Request/response-details voor debugging en audit

Doelmetrieken: 99,9% uptime, <100ms p95 latentie, <0,1% foutpercentage, <5 seconden gemiddelde detectietijd.

Health Checks

API Health Endpoint

Health Check
// Eenvoudige liveness check (geen auth vereist)
GET /health
// Response
HTTP/1.1 200 OK
{
 "status": "healthy",
 "timestamp": 1709980800000,
 "uptime": 99.95
}

Gedetailleerde Health Status

Detailed Health
// Gedetailleerde status met componentgezondheid
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
  }
}

Krijg je API-sleutel in 30 seconden

Klaar om te bouwen? Vraag een gratis API-sleutel aan (200 calls/dag, geen kaart nodig) en begin met het ophalen van live whale, funding en on-chain data.

Krijg je API-sleutel →

Metrieken & Monitoring

Belangrijke Metrieken om te Volgen

Metriek	Doel	Alertdrempel
Uptime	99.9%	<99.5%
P95 Latentie	<100ms	>500ms
Foutpercentage	<0.1%	>1%
Requests/sec	Varieert	Nadert limiet
Cache Hit Rate	>70%	<50%

Metrics API Endpoint

Metrics Query
// Haal API-metrieken op voor monitoring
GET /v1/metrics?period=1h
  -H "Authorization: Bearer token"
// Retourneert metrieken in Prometheus-formaat
# HELP api_requests_total Totaal aantal API-requests
# TYPE api_requests_total counter
api_requests_total{method="GET",status="200"} 4502
api_requests_total{method="GET",status="429"} 12

Alertinstellingen

Webhook Alerts

Maak Alert
POST /v1/alerts
  -H "Authorization: Bearer token"
  -d '{
 "name": "Hoog Foutpercentage",
 "condition": "error_rate > 0.01",
 "webhook_url": "https://hooks.slack.com/...",
 "severity": "high"
  }'

Alert Types

Uptime Alert — API langer dan 5 minuten onbeschikbaar
Latency Alert — P95 latentie overschrijdt drempel
Error Rate Alert — Foutpercentage boven 1%
Rate Limit Alert — Nadert rate limit
Data Freshness Alert — Data ouder dan drempel

Request Logging

Log Levels

Log Voorbeeld
// Typische API-request log entry
{
 "timestamp": "2026-03-21T14:00:00Z",
 "request_id": "req_abc123def456",
 methode: GET,
 pad: /v1/whales/btc,
 status: 200,
 duur_ms: 45,
 gebruikers_id: acct_12345
}

Gestructureerd Loggen

Alle logs zijn gestructureerde JSON voor eenvoudige verwerking en analyse:

Tijdsvermelding in ISO 8601-formaat
Request-ID voor tracing
HTTP-methode en pad
Reactiestatus en latentie
Gebruikers-ID en API-sleutelvingerafdruk
Foutmeldingen indien van toepassing

Gedistribueerde Tracing

Request-ID Tracking

Tracing Headers
// Alle verzoeken bevatten tracing headers
curl -H "X-Request-ID: req-abc123" \
  https://api.smartmoneyapi.com/v1/whales
// Reactie bevat hetzelfde ID
X-Request-ID: req-abc123
X-Response-Time: 45ms
X-Server: api-prod-01

Trace Context Propagatie

Gebruik W3C Trace Context-standaard voor gedistribueerde systemen:

W3C Trace Context
// Verzoek bevat trace context
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
tracestate: dd=s:0
// Trace-ID: 4bf92f3577b34da6a3ce929d0e0e4736
// Span-ID: 00f067aa0ba902b7
// Bemonsterd: true (01)

SLA-monitoring

Service Level Objectives

Plan	Uptime SLA	Reactietijd	Ondersteuning
Gratis	99%	Beste inspanning	Community
Trader	99.5%	<200ms p95	E-mail
Pro	99.95%	<100ms p95	Prioriteit
Enterprise	99.99%	<50ms p95	Toegewijd

SLA-tegoeden

Als de uptime onder de SLA zakt, ontvang je service-tegoeden:

99.0% - 99.5%: 10% maandelijkse tegoed
95.0% - 99.0%: 25% maandelijkse tegoed
< 95.0%: 100% maandelijkse tegoed

Monitoring Dashboards

Ingebouwd Dashboard

Toegang tot prestatie-dashboard op: https://status.smartmoney.io

Aangepast Dashboard Opzetten

Prometheus Query
// Query API-aanvraagsnelheid
rate(api_requests_total[5m])
// Query foutpercentage
rate(api_requests_total{status=~"5.."}[5m])
// Query latentiepercentiel
histogram_quantile(0.95, api_request_duration_ms)

Monitoring Tool Integratie

Ondersteunde Platforms

Tool	Integratie	Functies
Prometheus	Native /metrics endpoint	Metrics scraping
Grafana	Datasource plugin	Aangepaste dashboards
Datadog	API-integratie	APM tracing
New Relic	Agent-integratie	Volledige observability
PagerDuty	Webhook alerts	Incidentbeheer

Monitoring Best Practices

1. Monitor Belangrijke Metrieken

Focus op metrieken die direct invloed hebben op je bedrijf: uptime, latentie, foutpercentage.

2. Stel Geschikte Waarschuwingen In

Waarschuw op symptomen, niet alleen drempels. Routeer waarschuwingen op basis van ernst.

3. Gebruik Request-ID's

Correleer altijd verzoeken met unieke ID's voor end-to-end tracing.

4. Implementeer Gedistribueerde Tracing

Gebruik W3C Trace Context voor zichtbaarheid tussen microservices.

5. Regelmatige Alerting Tests

Test waarschuwingskanalen maandelijks om escalatie te garanderen.

6. Documenteer Alert Response

Maak runbooks voor veelvoorkomende waarschuwingen met oplossingsstappen.

Zorg voor 99,9% Uptime

Monitor Smart Money API met uitgebreide health checks, metrieken en waarschuwingen. Houd SLA-naleving in stand met ingebouwde observability-tools.

Aan de Slag

Pro- en Enterprise-abonnementen bevatten toegewijde ondersteuning en SLA-monitoring.