Executar consultas de registros no mecanismo do BigQuery

Este documento descreve como configurar a página Análise de observabilidade para executar consultas no mecanismo do BigQuery. É necessário executar consultas no mecanismo do BigQuery quando você tem políticas de alerta baseadas em SQL. Você também precisa usar esse mecanismo de consulta ao salvar gráficos baseados em SQL em um painel, e a consulta do gráfico une dados de observabilidade e outros dados comerciais.

A página Análise de observabilidade executa consultas no mecanismo de consulta padrão. No entanto, é possível configurar essa página para executar consultas no mecanismo do BigQuery. Os dois mecanismos de consulta executam consultas nos seus slots sem custo financeiro. No entanto, se você usar o mecanismo do BigQuery e reservar slots, ele vai executar as consultas nos slots reservados.

Se você usar o mecanismo de consulta padrão ou o do BigQuery, poderá consultar visualizações de observabilidade, visualizações em buckets de registros e visualizações de análise. Se você executar consultas no mecanismo de consulta padrão, suas permissões do Logging serão verificadas. No entanto, se você executar as consultas no mecanismo do BigQuery, as permissões do BigQuery serão verificadas.

Para saber mais, consulte Escolher o mecanismo de consulta da Análise de observabilidade.

Antes de começar

  1. Faça login na sua Google Cloud conta do. Se você não conhece o Google Cloud, crie uma conta para avaliar o desempenho dos nossos produtos em cenários reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho.

  2. 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.

    Go to project selector

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

  4. 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.

    Go to project selector

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

  6. Para receber as permissões necessárias para consultar um conjunto de dados vinculado do BigQuery Studio, peça ao administrador para conceder a você os seguintes papéis do IAM:

    Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

    Também é possível conseguir as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

  7. Verifique se você tem um conjunto de dados do BigQuery vinculado no bucket de registros. Se o conjunto de dados não existir, crie-o.

Se você planeja configurar a página Análise de observabilidade para executar consultas no mecanismo do BigQuery e estiver usando projetos com o VPC Service Controls, verifique se você está usando a edição Enterprise do BigQuery. Para saber mais, consulte Noções básicas sobre as edições do BigQuery.

Executar consultas da Análise de observabilidade no mecanismo do BigQuery

Quando você quiser monitorar os resultados da consulta SQL com uma política de alertas, execute as consultas no mecanismo do BigQuery fazendo o seguinte:

  1. Configure a Análise de observabilidade para executar as consultas no mecanismo do BigQuery:

    1. No Google Cloud console, acesse a página Análise de observabilidade:

      Acessar a análise de observabilidade

      Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.

    2. Na lista Visualizações de registros , encontre a visualização e selecione Consulta ou insira uma consulta.

      Se o painel de consultas mostrar uma mensagem de erro que faz referência à instrução FROM, a tabela não poderá ser resolvida para uma visualização de registros específica. Para informações sobre como resolver essa falha, consulte Erro FROM clause must contain exactly one log view.

    3. Acesse a barra de ferramentas e verifique se um botão chamado Executar no BigQuery aparece.

      Se a barra de ferramentas mostrar Executar consulta, então clique em Configurações e selecione BigQuery.

      Se o botão Executar no BigQuery estiver desativado, será necessário criar um conjunto de dados vinculado.

    4. Execute a consulta.

      É possível usar as opções da barra de ferramentas para formatar a consulta, limpar a consulta e abrir a documentação de referência do SQL do BigQuery.

Preços

Para saber mais sobre os custos associados ao uso do BigQuery, consulte a página de preços do BigQuery .

A seguir