Esegui query sui log sul motore BigQuery

Questo documento descrive come configurare la pagina Observability Analytics per eseguire query sul motore BigQuery. Devi eseguire le query sul motore BigQuery quando hai policy di avviso basate su SQL. Devi anche utilizzare questo motore di query quando salvi i grafici basati su SQL in una dashboard e la query del grafico unisce i dati di osservabilità e altri dati aziendali.

La pagina Observability Analytics esegue le query sul motore di query predefinito. Tuttavia, puoi configurare questa pagina per eseguire le query sul motore BigQuery. Entrambi i motori di query eseguono le query sugli slot senza costi. Tuttavia, se utilizzi il motore BigQuery e prenoti gli slot, questo motore esegue le query sugli slot prenotati.

Indipendentemente dal motore di query predefinito o dal motore BigQuery, puoi eseguire query sulle visualizzazioni di osservabilità, sulle visualizzazioni dei bucket di log e sulle visualizzazioni di analisi. Se esegui le query sul motore di query predefinito, vengono controllate le autorizzazioni di Logging. Tuttavia, se esegui le query sul motore BigQuery, vengono controllate le autorizzazioni di BigQuery.

Per saperne di più, consulta Scegli il motore di query di Observability Analytics.

Prima di iniziare

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

3. Per ottenere le autorizzazioni necessarie per eseguire query su un set di dati collegato da BigQuery Studio, chiedi all'amministratore di concederti i seguenti ruoli IAM:

   • Logs View Accessor (roles/logging.viewAccessor) on the project or on the view that you want to query.
   • Utente BigQuery (roles/bigquery.user) sul tuo progetto.
   • Utente job BigQuery (roles/bigquery.jobUser) sul tuo progetto.

   Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

   Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

4. Verifica di avere un set di dati BigQuery collegato nel bucket di log. Se il set di dati non esiste, crealo.

Se prevedi di configurare la pagina Observability Analytics per eseguire query sul motore BigQuery e utilizzi progetti con i Controlli di servizio Virtual Private Cloud (VPC), verifica di utilizzare l'edizione Enterprise di BigQuery. Per saperne di più, consulta Informazioni sulle edizioni di BigQuery.

Esegui query di Observability Analytics sul motore BigQuery

Quando vuoi monitorare i risultati della query SQL con una policy di avviso, esegui le query sul motore BigQuery procedendo nel seguente modo:

1. Configura Observability Analytics per eseguire le query sul motore BigQuery:

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

      Vai a Observability Analytics

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

   2. Nell'elenco Visualizzazioni di log, trova la visualizzazione, quindi seleziona Query o inserisci una query.

      Se il riquadro della query mostra un messaggio di errore che fa riferimento all'istruzione FROM, la tabella non può essere risolta in una visualizzazione di log specifica. Per informazioni su come risolvere questo errore, consulta Errore FROM clause must contain exactly one log view.

   3. Vai alla barra degli strumenti e verifica che venga visualizzato un pulsante con l'etichetta Esegui su BigQuery.

      Se la barra degli strumenti mostra Esegui query, allora fai clic su Impostazioni e seleziona BigQuery.

      Se il pulsante Esegui su BigQuery è disattivato, devi creare un set di dati collegato.

   4. Esegui la query.

      Puoi utilizzare le opzioni della barra degli strumenti per formattare la query, cancellarla e aprire la documentazione di riferimento di BigQuery SQL.

Prezzi

Per scoprire i costi associati all'utilizzo di BigQuery, consulta Prezzi di BigQuery.

Passaggi successivi

• Monitora i risultati della query SQL con una policy di avviso
• Salva e condividi una query SQL
• Esempi di query SQL
• Rappresenta graficamente i risultati della query SQL