Filtri di Cloud Trace

Puoi utilizzare i filtri di traccia per selezionare un insieme di tracce da Cloud Trace. Utilizza un filtro traccia in uno dei seguenti modi:

  • Come parametro filter in una query utilizzando la proprietà list.

  • Come parametro Filtro richiesta quando crei un report di analisi.

  • Come campo Filtro nella pagina Esplora tracce. Per informazioni su come creare e modificare questi filtri, consulta Visualizzare le tracce recenti.

I filtri ti consentono di specificare una o più condizioni che devono essere soddisfatte affinché una traccia venga visualizzata. La sintassi del filtro ti consente di definire quando le corrispondenze sono esatte o quando sono test dei prefissi. Tutte le corrispondenze sono sensibili alle maiuscole.

Panoramica dei filtri

I filtri di Trace sono costituiti da una sequenza di confronti chiamati termini. Le tracce devono corrispondono a tutti i termini da selezionare nel filtro. Ad esempio, il seguente filtro trova le tracce con una latenza di almeno un secondo e che contengono uno span denominato /modules.GetNumInstances:

+span:/modules.GetNumInstances latency:1s

Tutti i confronti delle stringhe sono sensibili alle maiuscole.

Attributi booleani

Per specificare i valori per gli attributi booleani, utilizza 0 per false e 1 per true. Ad esempio,

Client:0

Caratteri speciali

Per cercare un valore che contiene uno spazio o il carattere dei due punti (:), racchiudi il valore tra virgolette doppie ("). Ad esempio,

    label:"Notice: This value contains spaces and a colon"

Per cercare il carattere delle virgolette doppie o il carattere barra rovesciata (\) all'interno di una stringa tra virgolette, inserisci il carattere di escape con una barra rovesciata. Ad esempio,

    label:"Notice: This value contains spaces, a colon, a \"quote\", and a backslash (\\)"

Sintassi filtro

Nella tabella seguente e in altre parti di questa pagina, NAME si riferisce al nome di un campo, mentre VALUE si riferisce al valore di una coppia chiave-valore. Le stringhe _PREFIX e _EXACT sono indicazioni visive che indicano se un test è un test di prefisso o una corrispondenza esatta. Ad esempio, root:[NAME_PREFIX] significa che il nome dell'intervallo principale deve iniziare con [NAME_PREFIX].

La seguente tabella elenca la sintassi utilizzata per i filtri in Cloud Trace:


Filtro richiesta dell'API Trace nella pagina Report di analisi		 Filtra nella pagina Esplora tracce
root:[NAME_PREFIX] RootSpan:[NAME_PREFIX]
+root:[NAME_EXACT] RootSpan:+[NAME_EXACT]
span:[NAME_PREFIX] SpanName:[NAME_PREFIX]
+span:[NAME_EXACT] SpanName:+[NAME_EXACT]
[NAME_PREFIX] RootSpan:[NAME_PREFIX]
label:[LABEL_KEY] HasLabel:[LABEL_KEY]
[LABEL_KEY]:[VALUE_PREFIX] [LABEL_KEY]:[VALUE_PREFIX]*
+[LABEL_KEY]:[VALUE_EXACT] [LABEL_KEY]:+[VALUE]*
^[LABEL_KEY]:[VALUE_PREFIX] [LABEL_KEY]:^[VALUE_PREFIX]*
+^[LABEL_KEY]:[VALUE_EXACT] [LABEL_KEY]:^+[VALUE_EXACT]*, †
method:[VALUE_PREFIX] Method:[VALUE_PREFIX]
latency:10ms MinLatency:10ms
url:[VALUE_PREFIX] URL:[VALUE_PREFIX]

* Non utilizzare le seguenti parole chiave di Trace come chiavi di etichetta: root, span, label, method, latency e url. Tracce con questi non è possibile eseguire query sulle chiavi di etichetta.
† Nella pagina Esplora tracce, l'annotazione +^ viene convertita in ^+ quando premi Invio.

Il resto di questa pagina contiene una descrizione per i filtri quando vengono utilizzati API Trace e per il filtro di richiesta nella Pagina Report di analisi. Se utilizzi il campo Filtro nella pagina Esploratore traccia, puoi utilizzare la mappatura nella tabella precedente per creare un'espressione equivalente.

Esempi di filtri per le richieste

Di seguito sono descritti i termini di filtro:

root:[NAME_PREFIX]

Il nome dell'elemento root-span della traccia deve iniziare con [NAME_PREFIX]. Ad esempio, il seguente filtro corrisponde a una traccia denominata "/_ah/background", ma non a una denominata "/_ahx/background":

root:/_ah/
+root:[NAME]

Il nome dell'intervallo principale della traccia deve essere esattamente [NAME]. Ad esempio:

+root:/_ah/background
[NAME_PREFIX]

Questa sintassi è una scorciatoia per root:[NAME_PREFIX].

+[NAME]

Questa sintassi è una scorciatoia per +root:[NAME].

span:[NAME_PREFIX]

La traccia deve avere almeno uno span il cui nome inizia con [NAME_PREFIX]. Ad esempio:

span:/modules.
+span:[NAME]

La traccia deve avere almeno un intervallo con il nome esatto [NAME]. Ad esempio:

span:/modules.GetNumInstances
latency:[DURATION]

La traccia deve avere una latenza complessiva maggiore o uguale a [DURATION]. La durata è espressa come numero intero seguito da un specificatore di unità: s per i secondi, ms per i millisecondi o ns per i nanosecondi. Se non è presente alcun indicatore di unità, le unità sono espresse in millisecondi. Ad esempio, le seguenti quattro durate sono uguali:

 12s 12000ms 12000000ns 12000
label:[LABEL_KEY]

La traccia deve contenere esattamente la chiave dell'etichetta specificata. Il valore dell'etichetta (se presente) non è importante. Ad esempio,

label:/http/url
[LABEL_KEY]:[VALUE_PREFIX]

La traccia deve contenere esattamente la chiave di etichetta specificata e il valore l'etichetta deve iniziare con [VALUE_PREFIX]. Ad esempio, il termine corrisponde alle tracce la cui versione di App Engine inizia con "2017".

g.co/gae/app/module_version:2017
+[LABEL_KEY]:[VALUE_EXACT]

La traccia deve contenere esattamente la chiave e il valore di etichetta specificati. Ad esempio,

+g.co/gae/app/module_version:201750925t173233.387410594824284458
method:[VALUE_PREFIX]

Questa sintassi è una scorciatoia per il test delle etichette, /http/method:[VALUE_PREFIX].

+method:[VALUE_EXACT]

Questa sintassi è una scorciatoia per il test delle etichette, +/http/method:[VALUE_EXACT].

url:[VALUE_PREFIX]

Questa sintassi è una scorciatoia per il test delle etichette, /http/url:[VALUE_PREFIX].

+url:[VALUE_EXACT]

Questa sintassi è una scorciatoia per il test delle etichette, +/http/url:[VALUE_EXACT].

Esempi di ricerca in intervallo radice

Per limitare il termine di ricerca solo all'intervallo principale, aggiungi un (^) prima di un termine di ricerca e dopo l'eventuale (+). Per il campo Filtra nella pagina Esploratore traccia, se aggiungi l'annotazione +^, questa viene convertita in ^+ quando premi Invio.

Di seguito sono riportati alcuni termini di ricerca con intervallo principale e le relative equivalenze:

^label:[LABEL_KEY]
Questa è una ricerca con intervallo principale per label:[LABEL_KEY].
^[LABEL_KEY]:[VALUE_PREFIX]
Questa è una ricerca dell'intervallo principale di [LABEL_KEY]:[VALUE_PREFIX].
+^[LABEL_KEY]:[VALUE]
Questa è una ricerca dell'intervallo principale di +[LABEL_KEY]:[VALUE].
^method:[VALUE_PREFIX]
Questa è una ricerca con intervallo principale per method:[VALUE_PREFIX].
+^method:[VALUE]
Questa è una ricerca con intervallo principale per +method:[VALUE].
^url:[VALUE_PREFIX]
Questa è una ricerca con intervallo principale per url:[VALUE_PREFIX].
+^url:[VALUE]
Questa è una ricerca dell'intervallo principale di +url:[VALUE].
^span:[NAME_PREFIX]
Equivale a root:[NAME_PREFIX].
+^span:[NAME]
Questo è equivalente a +root:[NAME].

Creando una query con termini misti, la ricerca può essere ulteriormente personalizzata. Ad esempio,

    +^url:/main /images method:200

Corrisponde alle tracce quando l'etichetta dello spazio principale /http/url è esattamente "/main", il nome dello spazio principale è preceduto da /images e qualsiasi spazio ha l'etichetta /http/method con un valore di 200.

Risoluzione dei problemi

Questa sezione contiene contenuti per la risoluzione dei problemi.

Prestazioni lente

Se il filtro di traccia è complicato, l'esecuzione richiede più tempo e potrebbe fuori. Per migliorare il rendimento, semplifica il filtro.

Nessun risultato

Se il filtro non restituisce alcuna traccia, verifica quanto segue:

  • Assicurati che non ci siano spazi nel filtro, ad eccezione di quelli che separano i confronti.

  • Assicurati che l'uso delle lettere e l'ortografia di tutte le parole nel filtro siano corretto. Ad esempio, se scrivi erroneamente una parola chiave come method:GET, il filtro viene interpretato come label:method:GET, che non corrisponde a nessuna traccia.

  • Per testare i termini di filtro uno alla volta, utilizza il filtro Elenco di traccia o Explorer API. Se uno dei termini non restituisce risultati, potrebbe essere il responsabile.