Filtri Cloud Trace

Questo documento descrive come configurare i filtri quando utilizzi il metodo list dell'Cloud Trace API o quando crei un report di analisi. I filtri ti consentono di specificare una o più condizioni che devono essere soddisfatte per la restituzione di una traccia.

La pagina non si applica alla pagina Esplora traccia. Per filtrare i dati visualizzati in quella pagina, utilizza i filtri predefiniti elencati nel riquadro Filtri intervallo o la barra Filtro. Per ulteriori informazioni, vedi Trovare ed esplorare le tracce.

Panoramica dei filtri

I filtri Trace sono costituiti da una sequenza di confronti chiamati termini. Le tracce devono corrispondere a tutti i termini del filtro da selezionare. 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 una barra rovesciata prima del carattere. Ad esempio,

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

Sintassi filtro

In 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'elemento radice deve iniziare con [NAME_PREFIX].

Il resto di questa pagina contiene una descrizione dei filtri quando si utilizza l'Cloud Trace API e per il filtro delle richieste nella pagina Report di analisi.

Esempi di filtri delle 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'elemento root della traccia deve essere [NAME], esattamente. 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 uno span il cui nome è esattamente [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 un parametro di unità, le unità sono 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 dell'etichetta specificata e il valore dell'etichetta deve iniziare con [VALUE_PREFIX]. Ad esempio, il seguente 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 dell'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 con intervallo principale

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 Esplora tracce, 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 con intervallo principale per [LABEL_KEY]:[VALUE_PREFIX].
+^[LABEL_KEY]:[VALUE]
Questa è una ricerca con intervallo principale per +[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 con intervallo principale per +url:[VALUE].
^span:[NAME_PREFIX]
Questo è equivalente 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 traccia è complicato, l'esecuzione richiede più tempo e potrebbe scadere. Per migliorare le prestazioni, semplifica il filtro.

Nessun risultato

Se il filtro non restituisce tracce, controlla 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, vai al metodo dell'API list e poi utilizza Explorer API. Se uno dei termini non restituisce risultati, questo termine potrebbe essere il motivo per cui non vengono restituiti dati.

    Explorer API è aperto quando la pagina mostra un riquadro denominato Prova questo metodo. Se necessario, fai clic su Prova per aprire la pagina Esplora API.