Questo documento descrive come configurare la pagina Observability Analytics per eseguire query sul motore BigQuery. Devi eseguire query sul motore BigQuery quando hai criteri di avviso basati su SQL. Devi utilizzare questo motore di query anche quando salvi i grafici basati su SQL in una dashboard e la query unisce i dati di osservabilità e altri dati aziendali.
Per impostazione predefinita, la pagina Observability Analytics esegue query sul motore di query predefinito, che utilizza gli slot predefiniti per eseguire le query. Il motore BigQuery esegue anche query sugli slot predefiniti, a meno che tu non prenoti slot. La prenotazione degli slot può eliminare i ritardi che potrebbero verificarsi perché gli slot predefiniti sono occupati quando invii la query.
Indipendentemente dal motore di query predefinito o da BigQuery, puoi eseguire query su viste di osservabilità, viste sui bucket di log e viste di analisi.
Prima di iniziare
- Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Cloud Monitoring and Observability APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles.-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Cloud Monitoring and Observability APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles.-
Per ottenere le autorizzazioni necessarie per eseguire query da Observability Analytics utilizzando gli slot BigQuery, chiedi all'amministratore di concederti i seguenti ruoli IAM:
- Observability View Accessor (
roles/observability.viewAccessor) sulle visualizzazioni di osservabilità che vuoi interrogare. Questo ruolo supporta le condizioni IAM, che ti consentono di limitare la concessione a una visualizzazione specifica. Se non associ una condizione alla concessione del ruolo, l'entità può accedere a tutte le visualizzazioni di osservabilità. - Utente BigQuery (
roles/bigquery.user) sul tuo progetto - Utente job BigQuery (
roles/bigquery.jobUser) nel 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.
- Observability View Accessor (
- Verifica che esista il set di dati BigQuery collegato per il bucket di osservabilità denominato
_Trace. Se il set di dati BigQuery collegato non esiste, crealo.
Se prevedi di configurare la pagina Observability Analytics per eseguire query sugli slot BigQuery e se utilizzi progetti con i controlli di servizio VPC (Virtual Private Cloud), verifica di utilizzare BigQuery Enterprise Edition. Per ulteriori informazioni, vedi Informazioni sulle versioni di BigQuery.
Esegui query sul motore BigQuery
Per eseguire una query sul motore BigQuery quando utilizzi la pagina Analisi dell'osservabilità, procedi nel seguente modo:
-
Nella console Google Cloud , vai alla pagina manage_search Observability Analytics:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.
Inserisci o carica una query. Per saperne di più, vedi Eseguire query e analizzare le tracce.
Puoi salvare un grafico in una dashboard in cui il grafico mostra il risultato di un'unione tra i dati di osservabilità e altri dati aziendali. In questo caso, la clausola
FROMdeve specificare una visualizzazione di un set di dati di osservabilità o una visualizzazione di un bucket di log e deve essere presente anche un set di dati collegato per i dati interrogati. L'istruzioneJOINpuò specificare una tabella BigQuery. Tuttavia, devi disporre delle autorizzazioni IAM richieste per eseguire query sulla tabella BigQuery.Vai alla barra degli strumenti e verifica che venga visualizzato un pulsante con l'etichetta Esegui in BigQuery.
Se la barra degli strumenti mostra Esegui query, fai clic su settings Impostazioni e seleziona BigQuery.
Un pulsante Esegui su BigQuery disattivato indica che non esiste un set di dati collegato. Per risolvere questo errore, crea il set di dati BigQuery collegato.
Fai clic su Esegui in BigQuery.
Prezzi
Per informazioni sui costi associati all'utilizzo di BigQuery, consulta la pagina Prezzi di BigQuery.
Passaggi successivi
- Monitora i risultati delle query SQL con una policy di avviso.
- Salva e condividi una query SQL.
- Grafici dei risultati delle query SQL.
- Esempi di query SQL.