I tre pilastri dell'osservabilità

L'osservabilità è la capacità di comprendere lo stato interno di un sistema a partire dai dati che emette. Per un servizio in esecuzione, risponde a domande come: è in buona salute, perché è lento e che cosa ha avuto esito negativo? Si basa su tre pilastri: tracce, metriche e log.

OpenTelemetry (OTel) è uno standard indipendente dai vendor e un insieme di librerie per generare ed esportare dati di telemetria. Con una sola strumentazione è possibile inviare i dati a numerosi backend, come Jaeger, Prometheus o Grafana.

I log sono registrazioni con indicazione temporale di eventi distinti ("l'utente 42 ha effettuato l'accesso", "il pagamento non è riuscito"). Forniscono un contesto dettagliato e leggibile, ma possono essere rumorosi e difficili da aggregare se utilizzati da soli.

Le metriche sono misurazioni numeriche aggregate nel tempo, come il numero di richieste, il tasso di errore, i percentili di latenza e l'utilizzo della CPU. Sono economiche da memorizzare e ideali per dashboard e avvisi.

Le tracce seguono una singola richiesta mentre attraversa i servizi, suddividendola in span con indicazione temporale. Rivelano dove viene impiegato il tempo e quale dipendenza ha causato un rallentamento.

Le metriche indicano che cosa non funziona, ad esempio un picco nel tasso di errore. Le tracce indicano dove, ad esempio il servizio di pagamento. I log indicano perché, ad esempio un riferimento null per un ordine specifico. Insieme formano un quadro completo per il debugging.

Il vero potere deriva dalla correlazione. Un ID della traccia condiviso e applicato a log e span consente di passare da un avviso relativo a una metrica alla traccia esatta e ai relativi log di una singola richiesta non riuscita.

OTel chiama questi pilastri segnali. .NET li associa a primitive familiari: per le tracce si usano Activity/ActivitySource, per le metriche Meter e per i log ILogger.

Attivi i segnali con AddOpenTelemetry() e configuri tracce e metriche. Ogni aspetto viene trattato in dettaglio nelle lezioni successive.

Una risorsa descrive l'entità che produce la telemetria (nome del servizio, versione, ambiente). Impostarla in modo coerente consente ai backend di raggruppare e filtrare correttamente i dati.

OTel offre la strumentazione automatica per ASP.NET Core, HttpClient e altro, oltre alla strumentazione manuale, con cui è possibile aggiungere i propri span e metriche per ottenere informazioni specifiche sul business.

L'osservabilità si basa su tre pilastri: log (eventi, il perché), metriche (numeri aggregati, il quanto) e trace (span per richiesta, il dove). OpenTelemetry è lo standard indipendente dai vendor che emette tutti e tre come segnali, associati in .NET a Activity, Meter e ILogger. La correlazione tramite i trace id e una risorsa configurata correttamente li tiene collegati.