Tracce - Grafana gestito da Amazon
Aggiungere un pannello con visualizzazioni di tracciamentoAggiungere TraceQL con visualizzazioni di tabelle

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 9.x di Grafana, vedere. Lavorare nella versione 9 di Grafana

Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. Funzionamento in Grafana versione 8

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:

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 dashboardtraceID, 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.

Prerequisiti

Prima di iniziare è necessario disporre di quanto segue:

  • Uno spazio di lavoro Amazon Managed Grafana.

  • Una fonte di dati Tempo 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. La query determina i dati che vengono visualizzati nella visualizzazione. Per ulteriori informazioni sull'editor dei pannelli, consultate la documentazione dell'editor dei pannelli.

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.

  2. Scegli Aggiungi visualizzazione da una nuova dashboard o scegli Aggiungi pannello su una dashboard esistente.

  3. Seleziona la fonte di dati di tracciamento appropriata.

  4. In alto a destra dell'editor del pannello, scegliete la scheda Visualizzazioni e selezionate Tracce.

  5. Nelle opzioni del pannello, inserite un titolo per il pannello di tracciamento. Per ulteriori informazioni sull'editor dei pannelli, consultateConfigura le opzioni del pannello.

  6. Nell'editor di query, seleziona la scheda del tipo di query TraceQL.

  7. Inserisci ${traceId} nel campo di interrogazione TraceQL per creare una variabile del dashboard. Questa variabile viene utilizzata come query del modello.

  8. Scegliete Applica nell'editor del pannello per aggiungere il pannello alla dashboard.

  9. Vai alle Impostazioni del pannello di controllo e aggiungi una nuova variabile chiamatatraceId, di tipo variabile Personalizzata, assegnandole un'etichetta, se necessario. Scegli Applica per aggiungere la variabile alla dashboard.

  10. 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.

  2. Seleziona la stessa fonte di dati di traccia che hai usato nella sezione precedente.

  3. In alto a destra dell'editor del pannello, seleziona la scheda Visualizzazioni, quindi scegli Tabella.

  4. Nell'editor di query, scegli la scheda TraceQL.

  5. Nelle opzioni del pannello, inserisci un titolo per il pannello di tracciamento.

  6. 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 }

    Puoi 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.

  2. Aggiungi un titolo per il collegamento dati.

  3. 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

  4. 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'traceIdutilizzo 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. Per esempio:

    /d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}

  5. Scegli Salva per salvare il link ai dati.

  6. Scegliete Applica dall'editor del pannello per applicare il pannello alla dashboard.

  7. 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 esempioStart time, Duration o) segue automaticamente il collegamento datiName, compilando la variabile del dashboard e quindi mostra traceId la traccia pertinente nel pannello di traccia.