Filtri di Cloud Trace

Puoi utilizzare i filtri di traccia per selezionare un insieme di tracce da Cloud Trace. Utilizza un filtro di 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: Visualizza tracce recenti.

  Nota: la barra dei filtri nella pagina Esplora tracce si basa sul menu, e le opzioni dipendono dalla configurazione. Le opzioni basate sul menu di solito includono il filtro per stato HTTP e metodo HTTP. Quando utilizzi App Engine, sono inoltre disponibili opzioni per servizio e versione. Queste opzioni non sono disponibili quando utilizzi i filtri di Cloud Trace.

I filtri consentono di specificare una o più condizioni che devono essere soddisfatte per un la traccia da visualizzare. 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 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, usa 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 altri punti 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 Trace Explorer
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 traccia 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, il 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 in pagina Esplora tracce, puoi utilizzare il mapping nella precedente per creare un'espressione equivalente.

Esempi di filtri per le richieste

Di seguito vengono descritti i termini del 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 viene espressa sotto forma di numero intero seguito da unità specificato: 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. Per Ad esempio, le quattro durate seguenti sono le stesse:

 12s 12000ms 12000000ns 12000

label:[LABEL_KEY]

La traccia deve contenere esattamente la chiave dell'etichetta specificata. Il valore del parametro 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 una (^) prima di un termine di ricerca e dopo il parametro facoltativo (+). Per il campo Filtro della pagina Esplora tracce, se aggiungi il parametro l'annotazione +^, 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 dell'intervallo principale di label:[LABEL_KEY].

^[LABEL_KEY]:[VALUE_PREFIX]

Questa è una ricerca con intervallo principale per [LABEL_KEY]:[VALUE_PREFIX].

+^[LABEL_KEY]:[VALUE]

Questa è una ricerca dell'intervallo principale di +[LABEL_KEY]:[VALUE].

^method:[VALUE_PREFIX]

Questa è una ricerca dell'intervallo principale di method:[VALUE_PREFIX].

+^method:[VALUE]

Questa è una ricerca con intervallo principale per +method:[VALUE].

^url:[VALUE_PREFIX]

Questa è una ricerca dell'intervallo principale di url:[VALUE_PREFIX].

+^url:[VALUE]

Questa è una ricerca con intervallo principale per +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 presenta contenuti relativi alla risoluzione dei problemi.

Prestazioni lente

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

Nessun risultato

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

• Assicurati che il filtro non contenga spazi, ad eccezione di quelli che separando i confronti.

• Assicurati che l'ortografia e le maiuscole/minuscole di tutte le parole nel filtro siano risposta esatta. 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 del filtro uno alla volta, utilizza il filtro Elenco di tracce o Explorer API. Se uno dei termini non restituisce risultati, potrebbe essere il responsabile.