Salvare e condividere query SQL

Questo documento descrive come salvare e condividere le query create in Analisi dei log.

Questo documento presuppone la conoscenza dell'analisi dei log e di come utilizzare la pagina Analisi dei log per eseguire query sui dati di log. Se non hai familiarità con questi argomenti, consulta Eseguire query e analizzare i log.

Per scoprire come creare grafici dei risultati delle query e come salvarli in una dashboard personalizzata, consulta Creare grafici dei risultati delle query SQL.

Prima di iniziare

Prima di utilizzare Analisi dei log:

  • Per ottenere le autorizzazioni necessarie per utilizzare Log Analytics, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

    • Per eseguire una query sui bucket di log _Required e _Default: Visualizzatore log (roles/logging.viewer)
    • Per eseguire query su tutte le visualizzazioni dei log in un progetto: Logs View Accessor (roles/logging.viewAccessor)

    Puoi limitare un'entità a una visualizzazione di log specifica aggiungendo un'etichetta Condizione IAM alla concessione del ruolo Funzione di accesso a visualizzazione log effettuata in data a livello di progetto o aggiungendo un'associazione IAM dei criteri della vista log. Per ulteriori informazioni, vedi Controllare l'accesso a una visualizzazione del log.

    Si tratta delle stesse autorizzazioni necessarie per visualizzare le voci di log nella pagina Esplora log. Per informazioni sui ruoli aggiuntivi necessari per eseguire query sulle visualizzazioni dei bucket definiti dall'utente o per eseguire query sulla visualizzazione _AllLogs del bucket di log _Default, consulta Ruoli di Cloud Logging.

  • Assicurati di aver eseguito l'upgrade dei bucket di log per utilizzare Analisi dei log:

    1. Nella console Google Cloud, vai alla pagina Archiviazione dei log:

      Vai ad Archiviazione dei log

      Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.

    2. Per ogni bucket di log con una visualizzazione di log su cui vuoi eseguire una query, devi assicurarti che La colonna Analisi dei log disponibile mostra Apri. Se viene visualizzato Esegui l'upgrade, fai clic su Esegui l'upgrade e completa la finestra di dialogo.

Salva una query

Tutte le query eseguite vengono salvate automaticamente per 30 giorni e sono accessibili selezionando la scheda Recenti nella pagina Analisi dei log. Puoi cercare, visualizzare, eseguire e condividere query elencate nella scheda Recenti.

Se vuoi mantenere una query disponibile per un utilizzo futuro, annotala con informazioni utili per te o consenti ai colleghi di visualizzarla ed eseguirla, quindi salvala. Puoi cercare e ordinare le query salvate in base al nome, alla descrizione e all'etichetta di visibilità. Puoi inoltre modificare ed eliminare queste query. Le query salvate vengono conservate finché non le elimini.

Puoi salvare 10.000 query per progetto Google Cloud.

Console

Per salvare una query:

  1. Nella console Google Cloud, vai alla pagina Log Analytics:

    Vai ad Analisi dei log

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.

  2. Compila il riquadro Query con una query.

    Puoi compilare il riquadro Query inserendo una nuova query, selezionando una query dalla scheda Recenti o selezionando una query dalla scheda Salvate.

    Quando la query nel riquadro Query è valida, l'opzione Salva di sia abilitata.

  3. Fai clic su Salva e compila i campi Nome e Descrizione. I valori impostati per questi campi vengono mostrati nella scheda Salvati .

  4. (Facoltativo) Per consentire a tutti gli utenti con accesso alla pagina Log Analytics per la visualizzazione del progetto Google Cloud di eseguire la query salvata, attiva l'opzione di attivazione/disattivazione Condividi con il progetto.

    Per impostazione predefinita, questo pulsante di attivazione/disattivazione è disattivato e la visibilità è limitata a te.

  5. Fai clic su Salva query.

  6. (Facoltativo) Per visualizzare, ordinare ed eseguire le query salvate visibili a te, seleziona la scheda Salvati.

    Puoi ordinare e filtrare le query salvate in base al nome, alla descrizione e dell'etichetta di visibilità. Puoi anche filtrare in base ai contenuti della query.

Puoi modificare ed eliminare le query che hai creato utilizzando le opzioni disponibili nella scheda Salvate:

  • Per modificare una query, fai clic su Altre opzioni e seleziona Modifica. Puoi modificare i valori dei campi Nome e Descrizione, ma la query stessa non può essere modificata.

  • Per eliminare una query salvata, fai clic su Altre opzioni e seleziona Elimina.

API

Per salvare una query utilizzando l'API Logging, utilizza il metodo savedQueries.create. Per ulteriori informazioni su questo metodo, sui suoi parametri e sui dati di risposta, consulta la pagina di riferimento per savedQueries.create.

Puoi eseguire il metodo savedQueries.create utilizzando il metodo Widget Explorer API nella pagina di riferimento del metodo. Per le query Log Analytics, devi specificare il campo opsAnalyticsQuery. La L'esempio seguente illustra il corpo di una richiesta di esempio, che contiene un istanza di SavedQuery:

{
  "parent": "projects/my-project/locations/global"
  "saved_query":
  {
     "ops_analytics_query":
     {
        "sql_query_text" :
           "SELECT
           timestamp, log_name, severity, json_payload, resource, labels
           FROM
           `TABLE_NAME_OF_LOG_VIEW`
           WHERE
           timestamp > TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 HOUR)
           ORDER BY timestamp ASC
           LIMIT 100"
     }
     "visibility": "PRIVATE"
  }
}

Condividere una query

Console

Durante la risoluzione di un problema o quando vedi risultati anomali, potresti vuoi condividere una query e i suoi risultati con un membro del team. Quando è attiva la visualizzazione risultati della query sulla pagina Analisi dei log, puoi copiare un URL che, quando viene aperto, visualizza la query che hai eseguito e i relativi risultati.

Per condividere una query e i risultati con un collega:

  1. Nella console Google Cloud, vai alla pagina Analisi dei log:

    Vai ad Analisi dei log

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.

  2. Compila il riquadro Query con una query e poi fai clic su Esegui query.

    Puoi completare il riquadro Query inserendo una nuova query. selezionando una query dalla scheda Recenti o Selezionando una query dalla scheda Salvati.

  3. Fai clic su Condividi link.

  4. Invia il link al tuo compagno di squadra.

    Quando il tuo collega apre il link, viene visualizzata la pagina Log Analytics. Questa pagina mostra la query eseguita e i relativi risultati.

    Per aprire l'URL correttamente, il ruolo Identity and Access Management di un membro del tuo team del progetto Google Cloud devono includere le autorizzazioni necessarie per visualizzare Pagine di logging.

API

Puoi utilizzare l'API Logging per creare una query condivisa tramite: utilizzando il metodo savedQueries.Create e specificando il valore SHARED in il campo visibility. Per ulteriori informazioni, consulta la pagina di riferimento per savedQueries.create

Visualizzare ed eseguire query recenti o salvate

Per visualizzare o eseguire nuovamente una query, seleziona la scheda Recenti nella pagina Analisi dei log e trova la query:

  • Per eseguire la query, fai clic su Esegui.
  • Per visualizzare la query, utilizza le opzioni nella Menu Altre opzioni.

Per visualizzare, modificare o eseguire una query salvata, seleziona la scheda Salvati nella pagina Analisi dei log e trova la query:

  • Per eseguire la query, fai clic su Esegui.
  • Per modificare, visualizzare o eliminare la query, utilizza le opzioni nella Menu Altre opzioni.

Passaggi successivi