Tracce
Panoramica
La sezione APM > Traces visualizza le tracce raccolte dalle applicazioni e dai servizi.
Una traccia rappresenta il percorso seguito da una richiesta attraverso le applicazioni e i servizi. Ad esempio, quando un utente fa clic sul pulsante Place order in un negozio online, la richiesta può passare dal servizio frontend, attraverso i servizi di checkout e pagamento, fino al database.
Una traccia è costituita da span. Ogni span rappresenta una singola operazione, ad esempio una richiesta HTTP inviata dal servizio frontend al servizio di checkout, una query al database che salva l'ordine o una chiamata di funzione che calcola il costo di spedizione.
Gli span formano una gerarchia. Lo span radice rappresenta la prima operazione della richiesta. Ogni altro span è uno span figlio dello span durante il quale è stata avviata la relativa operazione. Ad esempio, il servizio frontend che riceve la richiesta Place order costituisce lo span radice, mentre il servizio di checkout che elabora l'ordine è il relativo span figlio.
Ogni span viene prodotto da un servizio (ad esempio zabbix-frontend; denominato dall'attributo della risorsa OpenTelemetry service.name) e da un ambito di strumentazione, ovvero la parte di codice che lo ha creato (ad esempio una libreria che traccia le richieste HTTP).
Per fornire il contesto relativo a ogni operazione, gli span dispongono anche di attributi chiave-valore: gli attributi dello span descrivono l'operazione stessa (ad esempio http.method: POST), mentre gli attributi della risorsa descrivono il servizio e l'ambiente in cui viene eseguito (ad esempio host.name: eabf8c2a5ddc).
Per ulteriori informazioni sulle tracce, consultare la documentazione di OpenTelemetry.
La sezione APM > Traces contiene i seguenti elementi:
- Pulsante Modalità kiosk - visualizza solo il contenuto della pagina, senza il menu e l'intestazione.
- Selettore del periodo di tempo - seleziona il periodo di tempo per il quale visualizzare le tracce.
- Filtro - visualizza solo le tracce di interesse.
- Elenco delle tracce - visualizza le tracce, descritte dai relativi span radice.
- Pannello della traccia - visualizza tutti gli span della traccia selezionata su una sequenza temporale.
Elenco delle trace
Ogni riga nell'elenco delle trace rappresenta una trace; le colonne mostrano i dati del relativo span radice.
Le trace vengono visualizzate in una tabella personalizzabile.
Il pulsante 
Personalizza tabella nell'intestazione della tabella consente di mostrare, nascondere o riordinare le colonne e di ripristinare il layout predefinito.
È inoltre possibile ridimensionare ogni colonna trascinandone il bordo destro; fare doppio clic sul bordo per ripristinare le dimensioni.
Tutte le personalizzazioni vengono applicate immediatamente e memorizzate per l'utente corrente.
L'elenco delle trace può contenere le seguenti colonne:
Ogni colonna corrisponde a una colonna nella tabella otel_traces della sorgente dati di telemetria; per l'elenco delle colonne, vedere Colonne di dati di telemetria supportate.
La maggior parte delle colonne ha lo stesso nome utilizzato nella sorgente dati (ad esempio, Trace ID corrisponde alla colonna TraceId).
Quando i nomi differiscono, nella tabella seguente viene specificata la colonna della sorgente dati.
| Colonna | Descrizione |
|---|---|
| Trace ID | ID della trace, condiviso da tutti gli span appartenenti alla trace. |
| Span ID | ID dello span radice. |
| Trace state | Dati aggiuntivi, se presenti, associati alla trace dagli strumenti di tracing (vedere W3C Trace Context). |
| Service name | Servizio che ha prodotto lo span radice, seguito dal numero di span nella trace. Se uno degli span ha il codice di stato Error (vedere di seguito), un'icona rossa mostra il relativo numero. |
| Operation name | Operazione rappresentata dallo span radice (ad esempio, POST /zabbix.php).Colonna della sorgente dati: SpanName. |
| Span kind | Ruolo dello span radice: Unspecified - non specificato. Internal - operazione eseguita all'interno di un'applicazione. Server - gestione di una richiesta in ingresso. Client - richiesta in uscita. Producer - creazione di un'operazione asincrona (ad esempio, l'invio di un messaggio). Consumer - elaborazione di un'operazione asincrona. |
| Scope name | Ambito di strumentazione che ha prodotto lo span radice. |
| Scope version | Versione dell'ambito di strumentazione. |
| Status code | Stato dell'operazione rappresentata dallo span radice: Unset - non è stato assegnato alcuno stato esplicito allo span radice. Ok - l'operazione è stata completata correttamente. Error - l'operazione è stata completata con un errore. |
| Status message | Informazioni aggiuntive, se presenti, sullo stato. |
| Start time | Data e ora di avvio dello span radice. Colonna della sorgente dati: Timestamp. |
| Span attributes | Attributi dello span radice. Fare clic sul pulsante con tre puntini  per visualizzare tutti gli attributi. |
| Resource attributes | Attributi della risorsa dello span radice. Fare clic sul pulsante con tre puntini per visualizzare tutti gli attributi. |
| Duration | Durata della trace; la barra grigia mostra la durata relativa alle altre trace. |
Pannello della traccia
Fare clic su una traccia nell'elenco delle tracce per aprire il pannello della traccia, che mostra tutti gli span della traccia su una sequenza temporale: quali operazioni sono state eseguite, in quale ordine e quanto tempo ha richiesto ciascuna.
Il pannello della traccia può contenere i seguenti elementi:
| Elemento | Descrizione |
|---|---|
| ID della traccia | ID della traccia selezionata. |
| Panoramica della sequenza temporale della traccia | L'intera traccia, con gli span disposti su un massimo di 8 righe (più span possono condividere una riga). Trascinare i bordi dell'intervallo selezionato, oppure l'intervallo stesso, per ingrandire la sequenza temporale degli span su quella parte della traccia. |
| Albero degli span | Gli span nella loro gerarchia; ciascuno mostra il proprio servizio (in grassetto), il nome dell'operazione e il numero di span figli diretti. |
| Sequenza temporale degli span | Gli span rappresentati come barre: la posizione e la lunghezza mostrano quando è iniziato ciascuno span e quanto tempo ha richiesto. I marcatori mostrano gli eventi (ad esempio, le eccezioni); passare il mouse su un marcatore o fare clic su di esso per visualizzarne i dettagli. |
| Dettagli dello span | Fare clic su uno span nell'albero degli span per visualizzarne i dettagli e gli attributi. |
Utilizzo del filtro
È possibile utilizzare il filtro per visualizzare solo le tracce di interesse.
Per filtrare in base agli attributi, immettere la chiave dell'attributo, selezionare l'operatore e immettere il valore dell'attributo.
Sono supportati i seguenti operatori:
- Contiene - (predefinito) il valore dell'attributo contiene la stringa immessa.
- Uguale - il valore dell'attributo è uguale alla stringa immessa.
- Non contiene - il valore dell'attributo non contiene la stringa immessa.
- Non uguale - il valore dell'attributo non è uguale alla stringa immessa.
- Esiste - esiste l'attributo con la chiave immessa.
- Non esiste - non esiste l'attributo con la chiave immessa.
Se si aggiungono più condizioni, selezionare come valutarle:
- And/Or - (predefinito) tutte le condizioni devono essere soddisfatte; le condizioni con la stessa chiave dell'attributo vengono combinate con Or.
- Or - deve essere soddisfatta almeno una condizione.