Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Tracce
****
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**
Per le aree di lavoro Grafana che supportano la versione 12.x di Grafana, vedere. [Funzionamento nella versione 12 di Grafana](using-grafana-v12.md)
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Funzionamento in Grafana versione 9](using-grafana-v9.md)
Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md)
Le visualizzazioni di Traces ti consentono di seguire una richiesta mentre attraversa i servizi della tua infrastruttura. La visualizzazione delle tracce mostra i dati delle tracce in un diagramma che consente di interpretarli facilmente.
Per ulteriori informazioni sulle tracce e su come utilizzarle, consulta la seguente documentazione:
+ [Tracciamento in Explore](v10-explore-tracing.md)
+ [Fonte dati Tempo](tempo-data-source.md)
+ [Guida introduttiva a Tempo](https://grafana.com/docs/tempo/latest/getting-started/) nella documentazione di *Grafana Labs* Tempo.
## Aggiungere un pannello con visualizzazioni di tracciamento
Una volta che i dati di tracciamento sono disponibili nello stack Grafana, puoi aggiungere pannelli di tracciamento alle dashboard Grafana.
L'utilizzo di una variabile del dashboard`traceID`, consente di creare una query per mostrare tracce specifiche per un determinato ID di traccia. Per ulteriori informazioni sulle variabili del dashboard, consulta la [documentazione Variables](v10-dash-variables.md).
**Prerequisiti**
Prima di iniziare è necessario disporre di quanto segue:
+ Uno spazio di lavoro Amazon Managed Grafana.
+ Una [fonte di dati Tempo](tempo-data-source.md) connessa al tuo spazio di lavoro.
Per visualizzare e analizzare i dati delle tracce in una dashboard, è necessario aggiungere la visualizzazione delle tracce alla dashboard e definire una query utilizzando l'editor del pannello. L'interrogazione determina i dati che vengono visualizzati nella visualizzazione. Per ulteriori informazioni sull'editor dei pannelli, consultate la [documentazione dell'editor dei pannelli](v10-panels-editor-overview.md).
Questa procedura utilizza variabili e modelli di dashboard per consentire di inserire ID di traccia che possono poi essere visualizzati. Utilizzerai una variabile chiamata `traceId` e la aggiungerai come query modello.
**Per aggiungere una query di visualizzazione delle tracce**
1. Nel tuo spazio di lavoro, crea una nuova dashboard o vai a una dashboard esistente in cui desideri aggiungere le visualizzazioni delle tracce.
1. Scegli **Aggiungi visualizzazione** da una nuova dashboard o scegli **Aggiungi pannello** su una dashboard esistente.
1. Seleziona la fonte di dati di tracciamento appropriata.
1. **In alto a destra dell'editor del pannello, scegliete la scheda **Visualizzazioni** e selezionate Tracce.**
1. Nelle **opzioni del pannello**, inserite un **titolo per il** pannello di tracciamento. Per ulteriori informazioni sull'editor dei pannelli, consultate[Configura le opzioni del pannello](v10-panels-configure-panel-options.md).
1. Nell'editor di query, seleziona la scheda del tipo di query **TraceQL**.
1. Inserisci `${traceId}` nel campo di interrogazione TraceQL per creare una variabile del dashboard. Questa variabile viene utilizzata come query del modello.
1. Scegliete **Applica** nell'editor del pannello per aggiungere il pannello alla dashboard.
1. Vai alle **Impostazioni** del pannello di controllo e aggiungi una nuova variabile chiamata`traceId`, di tipo variabile **Personalizzata**, assegnandole un'etichetta, se necessario. Scegli **Applica** per aggiungere la variabile alla dashboard.
1. Verifica che il pannello funzioni utilizzando un ID di traccia valido per l'origine dati utilizzata per il pannello di tracciamento e modificando l'ID nella variabile del dashboard.
## Aggiungere TraceQL con visualizzazioni di tabelle
Sebbene sia possibile aggiungere una visualizzazione di traccia a una dashboard, dover aggiungere manualmente gli ID di traccia come variabile del dashboard è complicato. È più utile invece poter utilizzare le query TraceQL per cercare tipi specifici di tracce e quindi selezionare le tracce appropriate dai risultati corrispondenti.
**Prerequisiti**
Questa procedura presuppone che sia stata completata la procedura precedente.
**Per aggiungere TraceQL con visualizzazioni di tabelle**
1. Nella stessa dashboard in cui hai aggiunto la visualizzazione della traccia, scegli **Aggiungi pannello per aggiungere un nuovo pannello** di visualizzazione.
1. Seleziona la stessa fonte di dati di traccia che hai usato nella sezione precedente.
1. **In alto a destra dell'editor del pannello, seleziona la scheda **Visualizzazioni**, quindi scegli Tabella.**
1. **Nell'editor di query, scegli la scheda TraceQL.**
1. Nelle **opzioni del pannello**, inserisci un **titolo per il** pannello di tracciamento.
1. Aggiungi una query TraceQL appropriata per cercare le tracce che desideri visualizzare nella dashboard. Ad esempio, ecco una semplice query statica proveniente da un server chiamato. {{my-server}}
```
{ .service.name = "{{my-server}}" && .http.status_code=500 }
```
È possibile scrivere la query TraceQL come query modello per sfruttare altre variabili del dashboard, se esistenti. Ciò consente di creare query dinamiche basate su queste variabili.
Quando i risultati vengono restituiti da una query, i risultati vengono visualizzati nella tabella del pannello.
I risultati della visualizzazione delle tracce includono collegamenti alla pagina **Esplora** che esegue il rendering della traccia. Puoi aggiungere altri link alle tracce nella tabella che compila la variabile del `traceId` dashboard quando selezionata, in modo che la traccia venga visualizzata nella stessa dashboard.
Per creare un set di link dati nel pannello, utilizzate la procedura seguente.
**Per utilizzare una variabile per aggiungere altri collegamenti alle tracce**
1. Nel menu a destra, in **Collegamenti dati**, scegli **Aggiungi link**.
1. Aggiungi un **titolo** per il collegamento dati.
1. Trova il percorso della dashboard cercando nella barra degli indirizzi del browser quando viene visualizzato il pannello di controllo completo. Poiché si tratta di un collegamento a una dashboard nello stesso stack Grafana, è richiesto solo il percorso della dashboard.
Ad esempio, se il percorso è:
```
https://g-example.grafana-workspace.us-east-1.amazonaws.com{{/d/1234abcd5/my-dashboard?orgId=1}}
```
Quindi il percorso verso la dashboard è:
```
/d/1234abcd5/my-dashboard?orgId=1
```
1. Nel campo **URL**, crea un riferimento automatico alla dashboard che contiene entrambi i pannelli. Questo riferimento automatico utilizza il valore della traccia selezionata nella tabella per compilare la variabile del dashboard. Utilizza il percorso per la dashboard del passaggio precedente, quindi inserisci il valore dell'`traceId`utilizzo dei risultati selezionati dalla tabella TraceQL. L'ID di traccia viene esposto utilizzando il campo `traceID` dati nei risultati restituiti, quindi utilizzalo come valore per la variabile del dashboard. Esempio:
```
/d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
```
1. Scegli **Salva** per salvare il link ai dati.
1. Scegliete **Applica** dall'editor del pannello per applicare il pannello alla dashboard.
1. Salva il pannello di controllo.
Ora dovresti vedere un elenco di tracce corrispondenti nella visualizzazione della tabella. Selezionando i campi **TraceID** **o** SpanID avrai la possibilità di aprire la pagina Esplora per visualizzare **la** traccia o di seguire il collegamento dati, selezionando qualsiasi altro campo (ad esempio`Start time`, `Duration` o) segue automaticamente il collegamento dati`Name`, compilando la variabile del dashboard e quindi mostrando `traceId` la traccia pertinente nel pannello di traccia.