Questa pagina è stata tradotta dall'API Cloud Translation.

Filtri Cloud Trace

Utilizza i filtri 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 che utilizza il metodo API list.
Come parametro Filtro richieste 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.

Nota: la barra dei filtri nella pagina Trace Explorer è basata su menu e le opzioni dipendono dalla configurazione. Le opzioni basate su menu solitamente includono il filtro in base allo stato HTTP e al metodo HTTP. Quando utilizzi App Engine, sono disponibili anche opzioni per il servizio e la versione. Queste opzioni non sono disponibili utilizzando i filtri di Cloud Trace.

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

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

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

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

Filtro Richiesta API di monitoraggio 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. Non è possibile eseguire query sulle tracce con queste chiavi di etichetta.
^† Nella pagina Esplora tracce, l'annotazione +^ viene convertita in ^+ quando premi Invio.

Il resto di questa pagina contiene una descrizione dei filtri quando si utilizza l'API Trace e per il filtro delle richieste 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 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 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 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, utilizza il filtro Elenco di traccia o Explorer API. Se uno dei termini non restituisce risultati, potrebbe essere il responsabile.