Crea query in Esplora log

Questo documento descrive come creare query in Esplora log di Google Cloud Console per recuperare e analizzare i log.

Per ulteriori informazioni sulle query in Esplora log, consulta la sezione Utilizzo di Esplora log.

Prima di iniziare

Per visualizzare i log che stai inviando da un account Amazon Web Services (AWS) a Logging, seleziona il progetto connettore AWS nel selettore di risorse di Google Cloud Console, quindi utilizza Logs Explorer. Il progetto connettore AWS archivia l'Amazon Resource Name (ARN) per il tuo account AWS e collega il tuo account AWS ai servizi Google Cloud. Per ulteriori informazioni, consulta Visualizzazione delle metriche per gli account AWS.

Assicurati di disporre delle autorizzazioni o del ruolo di gestione di identità e accessi corretti per creare query utilizzando Esplora log. Per maggiori dettagli sulle autorizzazioni IAM necessarie, consulta Controllo dell'accesso con le autorizzazioni IAM: console.

Inizia

Per iniziare a utilizzare la console per creare query, vai a Esplora log:

Vai a Esplora log

Seleziona il progetto Cloud o l'altra risorsa Google Cloud appropriata di cui vuoi visualizzare i log.

Creazione di query

Quando crei query in Esplora log, utilizzi principalmente il riquadro Query:

Riquadro delle query di Esplora log

Il riquadro Query offre diversi modi per creare ed eseguire espressioni di query:

  • Cerca il testo in tutti i campi dei log.
  • Seleziona le opzioni dai menu dei filtri.
  • Scrivi le query avanzate utilizzando il linguaggio di query di Logging.
  • Visualizza, modifica o esegui le query nelle schede Recenti, Salvate, Suggerite e Libreria.

Le seguenti sezioni descrivono in modo più dettagliato queste funzionalità.

Cerca testo nei campi dei log

Per cercare testo in tutti i campi dei log e trovare tutte le voci di log corrispondenti, inserisci i termini di ricerca nel campo di ricerca:

Il campo di ricerca di Esplora log nel riquadro delle query.

Per trovare le voci di log che contengono una frase, racchiudi i termini di ricerca tra virgolette; puoi inoltre utilizzare operatori booleani nelle espressioni di ricerca. Per visualizzare i tuoi termini di ricerca nell'espressione query, attiva Mostra query.

Dopo aver inserito i termini di ricerca, fai clic su Esegui query o premi il tasto INVIO. I risultati della query vengono visualizzati nel riquadro Risultati delle query.

Operatori booleani

Le voci dei campi di ricerca vengono convertite in espressioni booleane che specificano un sottoinsieme di tutte le voci di log nella risorsa Google Cloud selezionata.

Il campo di ricerca supporta l'utilizzo degli operatori booleani AND, OR e NOT. Quando utilizzi gli operatori booleani nelle espressioni di ricerca, tieni presente quanto segue:

  • Non puoi utilizzare le parentesi per nidificare le regole. Le parentesi nell'espressione di ricerca vengono analizzate come termini di ricerca.
  • Devi utilizzare la maiuscola per gli operatori booleani. Le lettere minuscole and, or e not vengono analizzate come termini di ricerca, non come operatori.

Se non includi alcun operatore, tutti i termini di ricerca e le frasi sono uniti da AND. Puoi omettere l'operatore AND tra i termini di ricerca.

Gli operatori AND e OR sono operatori di cortocircuito. Puoi combinare AND e OR regole nella stessa espressione. Ad esempio, quando i due operatori sono misti, l'espressione a AND b OR c AND d si trasforma nella seguente espressione del linguaggio di query di logging:

"a"
"b" OR "c"
"d"

L'operatore NOT ha la precedenza più alta, seguito da OR e AND in quest'ordine.

L'operatore NOT esegue una negazione del termine successivo. Ad esempio, NOT error restituisce le voci di log che non contengono error. Puoi anche sostituire l'operatore NOT con l'operatore - (meno). Ad esempio, le due query seguenti sono uguali:

response AND successful AND NOT error
response successful -error

Questa logica funziona anche con una frase, se l'operatore - (meno) non è compreso tra virgolette. Ad esempio, le seguenti due query sono le stesse:

-"response successful"
NOT "response successful"

Utilizzare i menu filtro

Puoi utilizzare i menu del filtro nel riquadro Query per aggiungere parametri risorsa, nome log e gravità del log al campo dell'editor query. Queste opzioni corrispondono ai campi LogEntry per tutti i log in Logging.

Filtra i menu per l'Editor query

  • Risorsa: consente di specificare il valore resource.type e quello resource.labels associato. Puoi selezionare un singolo tipo di risorsa utilizzando questo menu di filtro e zero o più etichette da applicare alla query. I parametri della risorsa sono uniti dall'operatore logico AND.
  • Log name (Nome log): consente di specificare il logName. Puoi selezionare più nomi di log da applicare alla query. Quando selezioni più nomi di log, viene utilizzato l'operatore logico OR.
  • Gravità: consente di specificare la gravità. Puoi selezionare più livelli di gravità contemporaneamente da aggiungere da applicare alla query. Quando selezioni più livelli di gravità, viene utilizzato l'operatore logico OR.

Per utilizzare uno qualsiasi dei menu del filtro, procedi nel seguente modo:

  1. Espandi uno qualsiasi dei menu del filtro nel riquadro Query.

  2. Perfezionare i parametri del filtro.

  3. Fai clic su Applica. Vedrai i parametri nel campo dell'editor query.

    Per visualizzare i tuoi termini di ricerca nell'espressione query, attiva Mostra query.

  4. Dopo aver esaminato la query, fai clic su Esegui query. I risultati della query vengono visualizzati nel riquadro Risultati delle query.

Per alcuni tipi di risorse Compute Engine, ad esempio gce_instance e gce_network, viene visualizzato il nome della risorsa con ID risorsa come sottotitolo. Ad esempio, per il tipo di risorsa gce_instance, vedi il nome della VM accanto all'ID della VM. I nomi delle risorse consentono di identificare l'ID risorsa corretto, in base al quale puoi creare query.

Scrivere query con limitazioni di tempo

Esistono due modi per eseguire query sui log in base all'ora:

  1. Esegui una query utilizzando il selettore dell'intervallo di tempo.
  2. Esegui una query utilizzando un'espressione timestamp nel campo dell'editor query.

Per eseguire rapidamente una query su secondi, minuti, ore o giorni, utilizza i valori preimpostati o inserisci un intervallo di tempo personalizzato utilizzando il selettore degli intervalli di tempo.

Per aggiungere un'espressione timestamp direttamente al campo dell'editor query, utilizza il linguaggio di query di logging.

Se il campo editor delle query contiene un'espressione con un timestamp, il selettore dell'intervallo di tempo è disattivato e la query utilizza l'espressione del timestamp come limitazione nell'intervallo di tempo. Se una query non utilizza un'espressione timestamp, questa utilizza il selettore dell'intervallo di tempo come limitazione per l'intervallo di tempo.

Utilizzare il selettore dell'intervallo di tempo

Il selettore dell'intervallo di tempo consente di limitare i risultati delle query in base all'intervallo di tempo:

Selettore intervallo di tempo nel riquadro query.

Per utilizzare il selettore dell'intervallo di tempo:

  1. Fai clic sul selettore degli intervalli di tempo nel riquadro Query.

  2. Seleziona l'intervallo di tempo appropriato per il quale vuoi visualizzare i log.

  3. Fai clic su Applica. Vedrai i parametri nel campo dell'editor query.

    Il riquadro Risultati delle query si adatta in base all'intervallo di tempo che hai selezionato.

L'intervallo di tempo predefinito è un'ora. Puoi utilizzare l'opzione Vai al tempo per limitare e centrare l'intervallo di tempo intorno a un timestamp specifico.

Puoi impostare le preferenze regionali, inclusa la formattazione di data e ora, dal selettore dell'intervallo di tempo:

  1. Seleziona Inserisci intervallo personalizzato.
  2. Seleziona Modifica formato data e ora.
  3. Aggiorna le tue preferenze nel menu Lingua e area geografica.
  4. Fai clic su Salva.

    Dopo aver aggiornato il browser, il formato di data e ora preferito viene visualizzato in Esplora log.

Scrivere query avanzate utilizzando il linguaggio di query di Logging

Puoi utilizzare il linguaggio di query di logging per creare query più avanzate nel campo editor di query di Esplora log:

  1. Se non vedi il campo editor della query nel riquadro Query, attiva Mostra query.

  2. Inserisci le espressioni di query direttamente nel campo dell'editor query.

    Se hai aggiunto termini di ricerca nel campo di ricerca o hai selezionato dei parametri nei menu dei filtri, questi vengono visualizzati anche nel campo dell'editor query e vengono valutati come parte dell'espressione di query.

  3. Dopo aver esaminato la query, fai clic su Esegui query.

    I log corrispondenti alla tua query sono elencati nel riquadro Risultati delle query. Anche i riquadri Istogramma e Campi log si adattano in base all'espressione della query.

Per esempi di query comuni che potresti voler utilizzare, vedi Esempi di query che utilizzano Esplora log.

Utilizzare le query recenti

Quando esegui una query, questa viene aggiunta al tuo elenco delle query Recenti, che contiene le ultime 10.000 query uniche in un periodo di 30 giorni.

Per visualizzare le query recenti, seleziona la scheda Recenti nel riquadro Query. Nella scheda Recenti sono disponibili le seguenti opzioni:

  • Stream: per eseguire la query e riprodurre i risultati, scegli questa opzione.
  • Esegui: per eseguire la query, scegli questa opzione.
  • Altre opzioni : consente di visualizzare l'espressione di query con le opzioni per eseguire la query o salvarla nell'elenco delle query salvate. Per ottenere queste opzioni, potete anche selezionare direttamente la query.

    Per salvare la query, procedi nel seguente modo:

    1. Fai clic su Salva con nome. Si apre la finestra di dialogo Salva query.
    2. Compila i seguenti campi:

      • Nome (obbligatorio): fornisci un nome per la query. I nomi sono limitati a 64 caratteri.
      • (Facoltativo) Descrizione: fornisci una descrizione per identificare lo scopo della query.
      • (Facoltativo) Includi campi di riepilogo: attiva Includi campi di riepilogo e inserisci i campi di riepilogo che vuoi visualizzare.
      • Tronca campi di riepilogo (facoltativo). Abilita Tronca campi di riepilogo e seleziona il numero di caratteri da troncare e se i troncamenti si verificano all'inizio o alla fine dei campi.
    3. Fai clic su Salva query. La query è ora disponibile nell'elenco Query salvate.

Puoi anche ordinare e filtrare le query recenti, in base al testo nell'espressione di query.

Salva query

Il riquadro Query contiene una scheda Salvate, dove puoi accedere alle tue query salvate. Le query salvate consentono di archiviare le espressioni di query in modo da esplorare i log in modo più coerente ed efficiente.

Per salvare un'espressione di query che hai creato nel campo query-editor, procedi nel seguente modo:

  1. Fai clic su Salva nel riquadro Query. Si apre la finestra di dialogo Salva query con l'espressione query nel campo Query editor.

  2. Compila i seguenti campi:

    • Nome (obbligatorio): fornisci un nome per la query. I nomi sono limitati a 64 caratteri.
    • (Facoltativo) Descrizione: fornisci una descrizione per identificare lo scopo della query.
    • (Facoltativo) Includi campi di riepilogo: attiva Includi campi di riepilogo e inserisci i campi di riepilogo che vuoi visualizzare.
    • Tronca campi di riepilogo (facoltativo). Abilita Tronca campi di riepilogo e seleziona il numero di caratteri da troncare e se i troncamenti si verificano all'inizio o alla fine dei campi.
    1. Fai clic su Salva query. Le query salvate vengono visualizzate in un elenco nella scheda Salvati.

Per eseguire una query salvata, fai clic su Esegui. Per eseguire la query e riprodurre i risultati, fai clic su Stream.

Puoi anche ordinare e filtrare le query salvate; il filtro corrisponderà al testo nell'espressione della query.

Condividi query

Le query condivise consentono agli utenti di un progetto Cloud di condividere tra di loro le query salvate. Puoi visualizzare le query condivise nella scheda Salvate.

Per i ruoli e le autorizzazioni necessari per visualizzare e modificare le query condivise, consulta le autorizzazioni della console. Tieni presente che gli utenti con il ruolo IAM roles/logging.admin o roles/editor possono modificare le query condivise di altri utenti.

Creare una query condivisa

Puoi condividere le query che hai già salvato o crearne una nuova.

Per creare e condividere una query, procedi nel seguente modo:

  1. Inserisci una query nel campo dell'editor query.

  2. Fai clic su Salva.

  3. Completa i campi nella finestra di dialogo Salva query.

  4. Attiva Condividi con progetto.

  5. Fai clic su Salva query.

La tua query viene ora condivisa con altri utenti del progetto Cloud.

Per condividere una query già salvata, procedi come segue:

  1. Seleziona la scheda Salvati.

  2. Seleziona Altre opzioni > Modifica oppure seleziona direttamente la query.

  3. Nella finestra di dialogo Modifica query, attiva Condividi con progetto, quindi fai clic su Aggiorna query.

La tua query viene ora condivisa con altri utenti del progetto Cloud.

Visualizza query condivise

Per visualizzare rapidamente tutte le query condivise, ordina la colonna Visibilità in modo da visualizzare per prime le query condivise.

  1. Seleziona la scheda Salvati.

  2. Fai clic su Tutte.

  3. Ordinare la colonna Visibilità.

La colonna Visibilità indica se e come le query sono condivise:

  • Condivisi da me: le query che hai salvato e condiviso con altri utenti del progetto Cloud.
  • Condivisi: query condivise da altri utenti del progetto Cloud.
  • Privato: query salvate e non condivise con altri utenti del progetto Cloud.

Visualizza solo le tue query

Per visualizzare le query salvate che hai creato o condiviso, fai clic su Miei. Viene visualizzato un elenco di query che hai creato e salvato. Nella colonna Visibilità puoi vedere le query private non condivise. Le query che hai condiviso sono indicate da Condivisi da me.

Utilizzare le query suggerite

Logging genera query suggerite in base al contesto del progetto cloud, ad esempio i prodotti Google Cloud che utilizzi. Queste query possono aiutarti a identificare i problemi e a fornirti informazioni sullo stato complessivo dei tuoi sistemi. Ad esempio, rilevando che stai utilizzando Google Kubernetes Engine, Logging potrebbe suggerire una query che trova tutti i log di errore per i tuoi container.

Per visualizzare ed eseguire le query suggerite, seleziona la scheda Suggeriti nel riquadro Query. La scheda Suggeriti mostra un elenco di query, ciascuna con descrizioni e le seguenti opzioni:

  • Stream: per eseguire la query e riprodurre i risultati, scegli questa opzione.
  • Esegui: per eseguire la query, scegli questa opzione.
  • Altre opzioni : consente di visualizzare i dettagli dell'espressione query con opzioni che consentono di eseguire la query o salvarla. Per ottenere queste opzioni, potete anche selezionare direttamente la query.

    Per esaminare i dettagli di una query suggerita, procedi in uno dei seguenti modi:

    • Seleziona la riga della query.

    • Fai clic su Altro e seleziona Visualizza. Si apre la finestra di dialogo Dettagli query.

    Nella finestra di dialogo Dettagli query, puoi visualizzare la query e le opzioni Esegui, Stream o Salva con nome:

    • Per salvare la query, procedi nel seguente modo:

      1. Fai clic su Salva con nome.
      2. Completa i campi nella finestra di dialogo Salva query.

      La query modificata viene visualizzata nell'elenco Salvati, dove puoi scegliere di eseguirla in un secondo momento.

    • Per eseguire subito la query, fai clic su Esegui. La query viene eseguita e appare nel campo "Editor query".

    • Per eseguire la query ora e riprodurre i risultati, fai clic su Stream.

    • Per chiudere la finestra di dialogo e tornare all'elenco delle query suggerite, fai clic su Chiudi.

Tieni presenti i seguenti comportamenti previsti:

  • I caricamenti di pagine successivi potrebbero non mostrare le stesse query nello stesso ordine.
  • Potresti non visualizzare alcuna query suggerita.
  • A volte l'esecuzione di una query suggerita restituisce zero log.

Seleziona le query dalla libreria

Logging fornisce una libreria di query basate su casi d'uso comuni e sui prodotti Google Cloud. Queste query possono aiutarti a trovare in modo efficiente i log durante le sessioni di risoluzione dei problemi critiche ed esplorarli per comprendere meglio quali sono i dati di logging disponibili.

Per visualizzare ed eseguire le query della libreria, procedi nel seguente modo:

  1. Seleziona la scheda Libreria nel riquadro Query.

  2. Nella colonna Tutte le query sono visualizzate ampie categorie di query e sottoinsiemi di query disponibili basati sui prodotti Google Cloud. Per restringere la selezione di query visualizzate, fai clic su uno dei prodotti.

    Puoi anche utilizzare il campo di ricerca per cercare le query disponibili per categoria, descrizione o contenuto dell'espressione query.

  3. Per esaminare un'espressione di query, procedi in uno dei seguenti modi:

    a. Fai clic sulla riga della query.

    b. Fai clic su Altro e seleziona Visualizza.

  4. Nella finestra di dialogo Dettagli query, puoi visualizzare la query e le opzioni Esegui, Stream o Salva con nome:

    • Per salvare la query, procedi nel seguente modo:

      1. Fai clic su Salva con nome.
      2. Completa i campi nella finestra di dialogo Salva query.

      La query modificata viene visualizzata nell'elenco Salvati, dove puoi scegliere di eseguirla in un secondo momento.

    • Per eseguire subito la query, fai clic su Esegui. La query viene eseguita e appare nel campo "Editor query".

    • Per eseguire la query ora e riprodurre i risultati, fai clic su Stream.

    • Per chiudere la finestra di dialogo e tornare all'elenco delle query suggerite, fai clic su Chiudi.