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à. # Tracciamento in Explore **** **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](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) Puoi usare Explore per visualizzare le tracce provenienti da fonti di dati di tracciamento. Sono supportate le origini dati seguenti. + [Tempo](tempo-data-source.md) (formati di inserimento supportati: Jaeger e OpenTelemetry Zipkin) + [Jaeger](jaeger-data-source.md) + [AWS X-Ray](x-ray-data-source.md) + [Zipkin](zipkin-data-source.md) Per informazioni su come configurare le query per le fonti di dati sopra elencate, consulta la documentazione relativa a una fonte di dati specifica. ## Editor della query Puoi interrogare e cercare dati di tracciamento utilizzando l'editor di query di un'origine dati. Ogni fonte di dati può avere il proprio editor di query. L'editor di query per l'origine dati Tempo è leggermente diverso dall'editor di query per l'origine dati Jaeger. Per informazioni sull'interrogazione di ciascuna fonte di dati, consulta la relativa documentazione. + [Tempo](tempo-data-source.md) + [Jaeger](jaeger-data-source.md) + [AWS X-Ray](x-ray-data-source.md) + [Zipkin](zipkin-data-source.md) ## Spiegazione di Trace View Questa sezione spiega gli elementi del pannello di controllo di Trace View. **Intestazione** L'intestazione della vista di traccia contiene i seguenti elementi: + Titolo dell'intestazione: mostra il nome dello span principale e dell'ID di traccia. + Cerca: evidenzia le aree contenenti il testo cercato. + Metadati: vari metadati relativi alla traccia. **Minimappa** Mostra una vista condensata della sequenza temporale della traccia. Trascina il puntatore sulla minimappa per ingrandire un intervallo di tempo più piccolo. Lo zoom aggiornerà anche la timeline principale, quindi è facile vedere intervalli più brevi. **Passando il mouse sulla minimappa, quando viene ingrandita, verrà visualizzato il pulsante Reimposta selezione che ripristina lo zoom.** **Filtri Span** Utilizzando i filtri Span, puoi filtrare gli intervalli nel visualizzatore della timeline di traccia. Più filtri aggiungi, più specifici sono gli intervalli filtrati. Puoi aggiungere uno o più dei seguenti filtri: + Nome del servizio di risorse + Nome Span + Durata + Tag (che includono tag, tag di processo e campi di registro) Per mostrare solo gli intervalli corrispondenti, scegli l'interruttore **Mostra solo corrispondenze**. **Pianificazione** Mostra l'elenco degli intervalli all'interno della traccia. Ogni riga di estensione è composta dai seguenti componenti: + Pulsante Espandi figli: espande o comprime tutti gli intervalli secondari dell'intervallo selezionato. + Nome del servizio: nome del servizio che ha registrato l'intervallo. + Nome dell'operazione: nome dell'operazione rappresentata da questo intervallo. + Barra della durata dell'intervallo: rappresentazione visiva della durata dell'operazione all'interno della traccia. **Dettagli Span** Scegliendo la riga di estensione vengono visualizzati i dettagli relativi all'estensione, inclusi i seguenti. + Nome operazione + Metadati Span + Tag: tutti i tag associati a questo intervallo. + Metadati del processo: metadati relativi al processo che ha registrato questo intervallo. + Registri: elenco dei log registrati da questo intervallo e dei valori chiave associati. Nel caso dei registri Zipkin, la sezione mostra le annotazioni Zipkin. **Traccia nei log** È possibile passare da un intervallo in una vista di traccia direttamente ai log pertinenti per quell'intervallo. È disponibile per le fonti di dati Tempo, Jaeger e Zipkin. Fai riferimento alla loro documentazione pertinente per istruzioni su come configurare ciascuna fonte di dati. Scegliete l'icona del documento per aprire una vista divisa in Explore con l'origine dati configurata e interrogare i log pertinenti per l'intervallo. **Ricalca le metriche** **Nota** Questa funzionalità è attualmente in versione beta Puoi passare da un intervallo in una vista di traccia direttamente alle metriche pertinenti per quell'intervallo. Questa funzione è disponibile per le sorgenti dati Tempo, Jaeger e Zipkin. Fate riferimento alla loro documentazione pertinente per i dettagli sulla configurazione. **Traccia fino ai profili** Utilizzando Trace to profiles, puoi sfruttare la capacità di Grafana di correlare segnali diversi aggiungendo la funzionalità di collegamento tra tracce e profili. ## Grafico dei nodi Facoltativamente, è possibile espandere il grafico del nodo per la traccia visualizzata. A seconda della fonte di dati, questo può mostrare gli intervalli della traccia come nodi nel grafico o aggiungere un contesto aggiuntivo, incluso il grafico del servizio basato sulla traccia corrente. ## Visualizzazione del grafico dei servizi La visualizzazione Service Graph visualizza le metriche di ampiezza (traccia i dati relativi a tassi, tassi di errore e durate (RED)) e i grafici dei servizi. Una volta impostati i requisiti, questa visualizzazione preconfigurata è immediatamente disponibile. Per ulteriori informazioni, consulta la pagina dell'origine dati di [Tempo](tempo-data-source.md). Puoi anche vedere la [pagina di visualizzazione del grafico dei servizi](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/) nella documentazione di *Grafana Labs Tempo.* ## Data API (API dati). Questa visualizzazione richiede una forma specifica dei dati da restituire dalla fonte dei dati per visualizzarli correttamente. L'origine dati deve restituire il frame e il set `frame.meta.preferredVisualisationType = 'trace'` di dati. **Struttura del frame di dati** Campi obbligatori; | Nome del campo | Tipo | Description | | --- | --- | --- | | TraceID | stringa | Identificatore per l'intera traccia. Dovrebbe esserci una sola traccia nel frame di dati. | | SPanID | stringa | Identificatore per l'intervallo corrente. L'intervallo IDs deve essere unico per traccia. | | ParentsPanID | stringa | spanID dello span principale per creare una relazione genitore-figlio nella vista trace. Può essere utilizzato undefined per root span senza un genitore. | | serviceName | stringa | Nome del servizio di cui fa parte questo span. | | ServiceTags | TraceKeyValuePair[] | Elenco dei tag rilevanti per il servizio. | | startTime | numero | Ora di inizio dell'intervallo in millisecondi. | | durata | numero | Durata dell'intervallo in millisecondi. | Campi opzionali: | Nome del campo | Tipo | Description | | --- | --- | --- | | log | TraceLog[] | Elenco dei log associati all'intervallo corrente. | | tag | TraceKeyValuePair[] | Elenco dei tag associati all'intervallo corrente. | | avvisi | stringa [] | Elenco degli avvisi associati all'intervallo corrente. | | StackTraces | stringa [] | Elenco delle tracce dello stack associate all'intervallo corrente. | | errorIconColor | stringa | Colore dell'icona di errore nel caso in cui span sia etichettato con. error: true | Per informazioni dettagliate sui tipi [TraceSpanRow](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L28), vedere [TraceKeyValuePair](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L4)e oltre [TraceLog](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L12). GitHub