Skip to Content

Log e trace

RocketAiFlow usa monitoraggio basato su OpenTelemetry per monitorare quello che succede durante l'esecuzione dei workflow, il comportamento telefonico, le azioni API, i servizi runtime e l'infrastruttura di supporto.

Log e trace vanno letti insieme. I log mostrano il dettaglio dell'evento: cosa è successo, quando è successo, quale servizio lo ha prodotto e quali metadati sono associati. I trace mostrano il percorso: come la stessa operazione attraversa i servizi e dove iniziano latenza, errori o comportamenti inattesi.

Perché usarli insieme

In un'investigazione di produzione, una singola riga di log spesso non basta. Anche un trace senza il contesto dei log può essere troppo astratto. Usarli insieme dà agli operatori una vista più chiara su:

  • eventi di avvio chiamata ed esecuzione campagna
  • cambi di stato di trunk, endpoint e telefonia
  • comportamento di function e azioni API
  • latenza dei servizi e percorsi di errore
  • metadati come campagna, contatto, operazione, risultato, nome servizio e identificativi trace

Grafana Drilldown

Grafana Drilldown è la vista avanzata per analizzare log e trace. Usala quando una dashboard mostra che qualcosa è cambiato e devi filtrare, cercare e correlare gli eventi che spiegano il problema.

  • filtrare i log per livello, servizio, campi, label e intervallo temporale
  • cercare dentro messaggi di log e metadati strutturati
  • aprire un evento di log e seguire il trace ID collegato
  • rivedere span, operazioni dei servizi, timing e metadati strutturati
  • correlare log e trace senza saltare tra strumenti separati
Vista log di Grafana Drilldown con volume log, eventi ricercabili, campi strutturati e trace collegato.
Grafana Drilldown permette agli operatori di cercare nei log, ispezionare metadati strutturati e seguire il trace collegato all'evento selezionato.
Vista trace di Grafana Drilldown con span rate, distribuzione durata, attributi servizio e dettaglio trace.
Le viste trace mostrano rate, durata, attributi servizio e comportamento degli span, così il team capisce dove un workflow consuma tempo.

Quando usare log e trace

  • una chiamata, campagna, transfer o azione API si comporta in modo diverso dal previsto
  • una dashboard mostra una variazione ma non l'evento che l'ha causata
  • il problema attraversa più servizi o integrazioni esterne
  • timing, latenza o retry devono essere spiegati con evidenza concreta
  • il troubleshooting richiede evidenza prima di modificare prompt, routing, campagne o functions

Percorso pratico di investigazione

  1. Parti dal sintomo in monitoring, call record o campaign analytics.
  2. Restringi l'intervallo temporale e route, campagna, contatto, trunk o servizio coinvolto.
  3. Usa i log per trovare il dettaglio dell'evento e i metadati strutturati.
  4. Segui il trace ID quando il problema attraversa più servizi o richiede analisi dei tempi.
  5. Torna al livello responsabile con evidenza: telefonia, logica workflow, runtime, azione API o dati.
Monitoring e visibilitàTorna al modello principale di monitoraggio per le operations live.Dashboard preconfigurateParti dalla vista dashboard prima di passare all'evidenza di log o trace.Risoluzione problemiUsa i controlli di setup dopo che log e trace indicano l'area probabile del workflow.
Last updated on
Quickstart