Indice dei contenuti

Panoramica Controlli di integrità Metriche e Monitoraggio Configurazione degli avvisi Registrazione delle richieste Tracciamento distribuito Monitoraggio SLA Dashboard Strumenti di monitoraggio Migliori pratiche

Documentazione API

Monitoraggio API, Metriche e Controlli di Integrità

Monitora Smart Money API con controlli di integrità completi, metriche delle prestazioni e avvisi. Tieni traccia dell'uptime, della latenza, dei tassi di errore e della conformità SLA.

Pubblicato il 21 marzo 2026 • 13 min di lettura • Operazioni

Panoramica del monitoraggio

Smart Money API offre funzionalità di monitoraggio complete per tracciare lo stato del servizio, le prestazioni e l'affidabilità. Implementa queste strategie di monitoraggio per rilevare tempestivamente i problemi e mantenere un alto uptime.

Tre livelli di monitoraggio:

Controlli di integrità — Disponibilità e funzionalità di base degli endpoint
Metriche — Dati sulle prestazioni (latenza, throughput, tassi di errore)
Registrazione — Dettagli di richiesta/risposta per debug e audit

Metriche obiettivo: 99.9% uptime, <100ms p95 latenza, <0.1% tasso di errore, <5 secondi tempo medio di rilevamento.

Controlli di integrità

Endpoint di integrità API

Controllo di integrità
// Controllo di vitalità semplice (nessuna autenticazione richiesta)
GET /health
// Risposta
HTTP/1.1 200 OK
{
 "status": "healthy",
 "timestamp": 1709980800000,
 "uptime": 99.95
}

Stato di integrità dettagliato

Integrità dettagliata
// Stato dettagliato con salute dei componenti
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
  }
}

Ottieni la tua API key in 30 secondi

Pronto a sviluppare? Ottieni una API key gratuita (200 chiamate/giorno, senza carta) e inizia a ottenere dati live su whale, funding e on-chain.

Ottieni la tua API key →

Metriche e Monitoraggio

Metriche chiave da monitorare

Metrica	Obiettivo	Soglia di allarme
Uptime	99.9%	<99.5%
Latenza P95	<100ms	>500ms
Tasso di errore	<0.1%	>1%
Richieste/sec	Variabile	Avvicinamento al limite
Tasso di cache hit	>70%	<50%

Endpoint API delle metriche

Query delle metriche
// Ottieni le metriche API per il monitoraggio
GET /v1/metrics?period=1h
  -H "Authorization: Bearer token"
// Restituisce le metriche in formato Prometheus
# HELP api_requests_total Totale richieste API
# TYPE api_requests_total counter
api_requests_total{method="GET",status="200"} 4502
api_requests_total{method="GET",status="429"} 12

Configurazione degli avvisi

Avvisi via Webhook

Crea avviso
POST /v1/alerts
  -H "Authorization: Bearer token"
  -d '{
 "name": "Alto tasso di errore",
 "condition": "error_rate > 0.01",
 "webhook_url": "https://hooks.slack.com/...",
 "severity": "high"
  }'

Tipi di avviso

Avviso di uptime — API non disponibile per più di 5 minuti
Avviso di latenza — Latenza P95 supera la soglia
Avviso di tasso di errore — Tasso di errore superiore all'1%
Avviso di limite di frequenza — Avvicinamento al limite di frequenza
Avviso di freschezza dei dati — Dati più vecchi della soglia

Registrazione delle richieste

Livelli di log

Esempio di log
// Tipica voce di log di una richiesta API
{
 "timestamp": "2026-03-21T14:00:00Z",
 "request_id": "req_abc123def456",
 metodo: GET,
 percorso: /v1/whales/btc,
 stato: 200,
 durata_ms: 45,
 ID utente: acct_12345
}

Registrazione Strutturata

Tutti i log sono in formato JSON strutturato per una facile analisi e parsing:

Timestamp in formato ISO 8601
ID richiesta per tracciamento
Metodo HTTP e percorso
Stato della risposta e latenza
ID utente e impronta digitale della chiave API
Messaggi di errore, se applicabili

Tracciamento Distribuito

Tracciamento ID Richiesta

Intestazioni di Tracciamento
// Tutte le richieste includono intestazioni di tracciamento
curl -H "X-Request-ID: req-abc123" \
  https://api.smartmoneyapi.com/v1/whales
// La risposta include lo stesso ID
X-Request-ID: req-abc123
X-Response-Time: 45ms
X-Server: api-prod-01

Propagazione del Contesto di Tracciamento

Utilizza lo standard W3C Trace Context per sistemi distribuiti:

W3C Trace Context
// La richiesta include il contesto di tracciamento
traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01
tracestate: dd=s:0
// ID Traccia: 4bf92f3577b34da6a3ce929d0e0e4736
// ID Span: 00f067aa0ba902b7
// Campionato: true (01)

Monitoraggio SLA

Obiettivi di Livello di Servizio

Piano	SLA di Uptime	Tempo di Risposta	Supporto
Gratuito	99%	Sforzo massimo	Comunità
Trader	99.5%	<200ms p95	Email
Pro	99.95%	<100ms p95	Priorità
Enterprise	99.99%	<50ms p95	Dedicato

Crediti SLA

Se l'uptime scende sotto lo SLA, ricevi crediti di servizio:

99.0% - 99.5%: 10% di credito mensile
95.0% - 99.0%: 25% di credito mensile
< 95.0%: 100% di credito mensile

Dashboard di Monitoraggio

Dashboard Integrato

Accedi al dashboard delle prestazioni all'indirizzo: https://status.smartmoney.io

Configurazione Dashboard Personalizzato

Query Prometheus
// Interroga il tasso di richieste API
rate(api_requests_total[5m])
// Interroga il tasso di errore
rate(api_requests_total{status=~"5.."}[5m])
// Interroga il percentile di latenza
histogram_quantile(0.95, api_request_duration_ms)

Integrazione Strumenti di Monitoraggio

Piattaforme Supportate

Strumento	Integrazione	Funzionalità
Prometheus	Endpoint /metrics nativo	Scraping delle metriche
Grafana	Plugin Datasource	Dashboard personalizzati
Datadog	Integrazione API	Tracciamento APM
New Relic	Integrazione Agent	Osservabilità completa
PagerDuty	Avvisi Webhook	Gestione degli incidenti

Migliori Pratiche di Monitoraggio

1. Monitora le Metriche Chiave

Concentrati sulle metriche che impattano direttamente il tuo business: uptime, latenza, tasso di errore.

2. Imposta Avvisi Appropriati

Avvisa sui sintomi, non solo sulle soglie. Instrada gli avvisi per gravità.

3. Usa gli ID Richiesta

Correla sempre le richieste con ID univoci per il tracciamento end-to-end.

4. Implementa il Tracciamento Distribuito

Usa W3C Trace Context per la visibilità tra microservizi.

5. Test Regolari degli Avvisi

Testa i canali di avviso mensilmente per garantire che l'escalation funzioni.

6. Documenta la Risposta agli Avvisi

Crea manuali operativi per gli avvisi comuni con i passi di risoluzione.

Garantisci il 99.9% di Uptime

Monitora Smart Money API con controlli di salute completi, metriche e avvisi. Mantieni la conformità SLA con strumenti di osservabilità integrati.

Inizia

I piani Pro e Enterprise includono supporto dedicato e monitoraggio SLA.