Osservabilità delle integrazioni B2B su Azure (log, metriche, alert)

Le integrazioni B2B vivono tra sistemi diversi e falliscono in modi silenziosi: un ordine non importato, un prezzo non aggiornato, un payout non riconciliato. Senza osservabilità ci si accorge dei problemi troppo tardi. Vediamo come renderle trasparenti su Microsoft Azure.

I tre pilastri

Pilastro	A cosa serve
Log	Cosa è successo, nel dettaglio, per ogni operazione
Metriche	Quanto e quanto spesso: volumi, latenze, errori
Tracce	Il percorso di una richiesta attraverso i componenti

Log strutturati e correlation ID

I log utili non sono frasi libere ma eventi strutturati con campi coerenti (operazione, esito, durata, canale, identificatori). Il pezzo chiave è il correlation ID: un identificatore che accompagna un'operazione dall'ingresso fino a tutti i passi a valle, così è possibile ricostruire l'intera vicenda di un singolo ordine attraverso code e worker.

Metriche tecniche e di business

Oltre alle metriche tecniche (latenza, tasso di errore, profondità delle code) servono le metriche di business: ordini importati per ora, prodotti sincronizzati, payout riconciliati, percentuale di disapprovazioni feed. Sono queste a dire se il sistema sta facendo davvero il suo lavoro.

Application Insights e distributed tracing

Su Azure, Application Insights raccoglie log, metriche e tracce e correla automaticamente le chiamate tra Functions, code e dipendenze esterne. Il distributed tracing mostra il percorso end-to-end di una richiesta, rendendo evidente dove si perde tempo o dove un passo fallisce.

Alert utili, non rumorosi

Un alert ha valore solo se è azionabile. Conviene allertare su sintomi concreti:

• crescita anomala della dead-letter queue;
• tasso di errore oltre soglia su un'API marketplace;
• nessun ordine importato in una finestra in cui dovrebbero arrivarne;
• differenze di riconciliazione payout oltre una soglia.

Troppi alert generano assuefazione: meglio pochi segnali significativi.

Dashboard operative

Una buona dashboard risponde a una domanda semplice: "il flusso sta funzionando?". Mostra volumi recenti, errori, latenze e lo stato delle code, così un'occhiata basta a capire la salute del sistema.

Errori comuni

• log non strutturati e impossibili da interrogare;
• nessun correlation ID per seguire un'operazione;
• solo metriche tecniche, nessuna metrica di business;
• alert troppi o troppo generici, quindi ignorati.

Conclusione

L'osservabilità non è un lusso: è ciò che permette di gestire integrazioni B2B con fiducia. Log strutturati con correlation ID, metriche tecniche e di business, distributed tracing e alert azionabili — con Application Insights su Azure — rendono visibile l'invisibile. Riferimento: Application Insights (Microsoft Learn).