Executar consultas 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 une dados de observabilidade e outros dados comerciais.

Por padrão, a página Análise de observabilidade executa consultas no mecanismo de consulta padrão, que usa os slots padrão para executar suas consultas. O mecanismo do BigQuery também executa consultas nos slots padrão, a menos que você reserve slots. A reserva de slots pode remover atrasos que podem ocorrer porque os slots padrão estão ocupados quando você envia a consulta.

Se você usa o mecanismo de consulta padrão ou o mecanismo do BigQuery, é possível consultar visualizações de observabilidade, visualizações em buckets de registros e visualizações de análise.

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. 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 the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

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

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

  7. 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 the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

    8.

  8. Para receber as permissões necessárias para executar consultas na Análise de observabilidade usando slots do BigQuery, peça ao administrador para conceder a você os seguintes papéis do IAM:

    • Acessador de visualização de observabilidade (roles/observability.viewAccessor) nas visualizações de observabilidade que você quer consultar. Esse papel oferece suporte a condições do IAM, que permitem restringir a concessão a uma visualização específica. Se você não anexar uma condição à concessão de papel, o principal poderá acessar todas as visualizações de observabilidade.
    • Usuário do BigQuery (roles/bigquery.user) no seu projeto
    • Usuário de jobs do BigQuery (roles/bigquery.jobUser) no seu projeto

    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.

  9. Verifique se o conjunto de dados vinculado do BigQuery para o bucket de observabilidade chamado _Trace existe. Se o conjunto de dados vinculado do BigQuery não existir, crie-o.

Se você planeja configurar a página Análise de observabilidade para executar consultas nos slots do BigQuery e estiver usando projetos com o VPC Service Controls, verifique se você está usando a edição Enterprise do BigQuery. Para mais informações, consulte Entender as edições do BigQuery.

Executar consultas no mecanismo do BigQuery

Para executar uma consulta no mecanismo do BigQuery ao usar a página Análise de observabilidade, faça o seguinte:

  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. Insira ou carregue uma consulta. Para mais informações, consulte Consultar e analisar traces.

    É possível salvar um gráfico em um painel em que ele mostra o resultado de uma união entre dados de observabilidade e outros dados comerciais. Nesse caso, a cláusula FROM precisa especificar uma visualização em um conjunto de dados de observabilidade ou uma visualização em um bucket de registros, e também precisa haver um conjunto de dados vinculado para os dados consultados. A instrução JOIN pode especificar uma tabela do BigQuery. No entanto, você precisa ter as permissões do IAM necessárias para consultar a tabela do BigQuery.

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

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

    Um botão Executar no BigQuery desativado indica que não há um conjunto de dados vinculado. Para resolver essa falha, crie o conjunto de dados vinculado do BigQuery.

  4. Clique em Executar no 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