Le risposte lente di un'API sono clienti che aspettano, integrazioni che falliscono, timeout nei sistemi altrui. Sulle nostre API il volume mensile è cresciuto di 22 volte in 5 mesi (da 4.743 richieste a marzo a 107.065 a luglio). I casi peggiori sono passati da risposte oltre 6 secondi a outlier sempre più rari. La latenza mediana oggi è di 159 millisecondi, il 95esimo percentile di 642 millisecondi (dati di produzione Zornade, marzo-agosto 2026).
Come siamo arrivati fin qui, e come si replica.
Il monitoraggio prima, l'ottimizzazione dopo
L'errore più comune è ottimizzare alla cieca. Si indovina la query lenta, si riscrive, si misura male. Il monitoraggio corretto inverte l'ordine.
- Misurare tutto, sempre. Ogni richiesta con endpoint, tempo di risposta ed esito, in un log interrogabile. Da qui nascono i percentili reali, non le medie rassicuranti.
- Guardare i percentili, non la media. La media nasconde le code. Una API con mediana rapida può avere il 5% delle richieste in timeout, e sono esattamente quelle che gli utenti ricordano.
- Incrociare con il carico. I rallentamenti coincidono coi picchi? Allora è capacità. Compaiono a caso? Allora è una rotta specifica o una dipendenza esterna.
- Ottimizzare dove i dati indicano. Ogni intervento nasce da una dashboard che indica l'endpoint, non da una sensazione.
Cosa dicono le nostre dashboard
Le nostre 12 dashboard Grafana rispondono ogni giorno a tre domande. Qual è la latenza per endpoint. Quanti errori ci sono. Cosa succede quando il traffico cresce. I numeri di oggi sono questi. 251.666 richieste servite da marzo ad agosto. 195 clienti API attivi. Una distribuzione di latenza che ha smesso di avere code di secondi. Il dato peggiore di marzo (6,6 secondi) era il sintomo di rotte e cache non ottimizzate. La dashboard l'ha mostrato, noi l'abbiamo corretto.
Il costo di non monitorare
Un'API lenta si fa sentire altrove. Timeout nelle integrazioni dei clienti, ticket di supporto, integrazioni abbandonate. Le ricerche di Google indicano che il 53% degli utenti mobile abbandona un sito che impiega più di 3 secondi a caricare (Marketing Dive), e gli studi Akamai stimano che ogni 100 millisecondi di ritardo possano costare fino al 7% di conversioni (analisi degli studi). Quando il problema diventa un fermo vero, i numeri si fanno grandi. La ricerca ITIC 2024 stima il costo medio di un'ora di downtime oltre i 300.000 dollari per la grande maggioranza delle aziende (fonte). Per l'Uptime Institute, più della metà delle organizzazioni dichiara che l'ultimo outage grave è costato oltre 100.000 dollari (fonte). Monitorare costa giorni. Non monitorare costa clienti. Il confronto tra sviluppare e comprare vale anche qui. L'infrastruttura di misura si costruisce una volta e serve per sempre.
Domande frequenti
Quali metriche contano davvero per un'API?
Percentili di latenza (p50, p95, p99), tasso di errore per endpoint, volume per cliente. La media da sola è fuorviante, da ignorare come unico indicatore.
Ogni quanto si misura?
In continuo. Il log di ogni richiesta è il dato di partenza, la dashboard lo aggrega in tempo reale e gli allarmi scattano sulle anomalie, non sulle soglie arbitrarie.
Serve Grafana per forza?
Grafana è la scelta open source più diffusa, ma il principio vale con qualsiasi strumento. Prima la misura, poi l'ottimizzazione. Noi usiamo Grafana perché unisce API, infrastruttura e business nello stesso cruscotto.
Per monitoraggio e ottimizzazione API su misura, la prima analisi dei tuoi tempi di risposta è gratuita.