Filtri Cloud Trace

Questo documento descrive come configurare i filtri quando utilizzi il metodo list dell'Cloud Trace API. 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 tracce. 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 un intervallo 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 false per false e true per true:

Client:true

Caratteri speciali

I valori semplici, ovvero quelli che corrispondono all'espressione regolare [a-zA-Z0-9./_][a-zA-Z0-9./_-]*, possono essere forniti senza virgolette:

environment:production
path:/index.html
error_code:200

I valori che includono altri caratteri, inclusi gli spazi, devono essere racchiusi tra virgolette doppie ("):

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

Per cercare il carattere virgolette doppie o il carattere barra rovesciata (\) all'interno di una stringa tra virgolette, inserisci una barra rovesciata prima del carattere:

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

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-span 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 รจ [NAME], esattamente. 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.