Salvar ou compartilhar consultas SQL

Neste documento, descrevemos como salvar e compartilhar consultas criadas no Log Analytics.

Para informações sobre como criar gráficos das suas consultas ou exemplos de consultas, consulte os documentos listados na seção Próximas etapas deste documento.

Antes de começar

Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

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

Verify that billing is enabled for your Google Cloud project.

Ative a API Observability.

Funções necessárias para ativar APIs

Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder papéis.

Ativar a API

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

Verify that billing is enabled for your Google Cloud project.

Ative a API Observability.

Funções necessárias para ativar APIs

Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder papéis.

Ativar a API

1. Para receber as permissões necessárias para carregar a página Análise de dados de registros, escrever, executar e salvar consultas particulares, 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 aceita 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. As visualizações de observabilidade estão no Acesso antecipado.
   • Usuário do Analytics de observabilidade (roles/observability.analyticsUser) no seu projeto. Esse papel contém as permissões necessárias para salvar e executar consultas particulares e compartilhadas.
   • Visualizador de registros (roles/logging.viewer) no seu projeto.
   • Acessador de exibição de registros (roles/logging.viewAccessor) no projeto que armazena as visualizações de registros que você quer consultar.

   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 usando papéis personalizados ou outros papéis predefinidos.

   Observação: se você quiser criar e gerenciar consultas compartilhadas, os papéis anteriores do IAM não serão suficientes. Para criar e gerenciar consultas compartilhadas, seus papéis do IAM precisam incluir as permissões logging.queries.{share, updateShared, deleteShared}.

Salvar uma consulta

Todas as consultas executadas são salvas automaticamente por 30 dias e podem ser acessadas na guia Recente da página Análise de dados de registros. Você pode pesquisar, visualizar, executar e compartilhar as consultas listadas na guia Recentes.

Se você quiser manter uma consulta disponível para uso futuro, anote-a com informações úteis ou permita que colegas de equipe vejam e executem sua consulta. É possível pesquisar e classificar as consultas salvas pelo nome, descrição e rótulo de visibilidade. Você também pode editar e excluir essas consultas. As consultas salvas são mantidas até que você as exclua.

É possível salvar 10.000 consultas por projeto do Google Cloud .

Console

Para salvar uma consulta, faça o seguinte:

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

   Acesse Análise de registros

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

2. Preencha o painel Consulta com uma consulta.

   Para preencher o painel Consulta, insira uma nova consulta, selecione uma na guia Recente ou na guia Salvas.

   Sua consulta pode incluir qualquer visualização válida, várias visualizações e visualizações do Google Analytics.

   Quando a consulta no painel Consulta é válida, o botão salvar Salvar é ativado.

3. Clique em Salvar Salvar, selecione Salvar consulta e preencha os campos Nome e Descrição. Os valores definidos para esses campos são mostrados na guia Salvo.

4. Opcional: para permitir que todos com acesso à página Análise de dados de registros da visualização do projeto Google Cloud executem a consulta salva, ative a opção Compartilhar com o projeto.

   Por padrão, essa opção está desativada e a visibilidade é restrita a você.

5. Clique em Salvar consulta.

6. Opcional: para ver, classificar e executar consultas salvas que estão visíveis para você, selecione a guia Salvas.

   É possível classificar e filtrar as consultas salvas por nome, descrição e rótulo de visibilidade. Também é possível filtrar pelo conteúdo da consulta.

É possível editar e excluir consultas criadas usando as opções na guia Salvas:

• Para editar uma consulta, clique em Mais opções e selecione Editar. É possível modificar os valores dos campos Nome e Descrição, mas a consulta em si não pode ser modificada.

• Para excluir uma consulta salva, clique em Mais opções e selecione Excluir.

Compartilhar uma consulta

É possível compartilhar uma consulta salva com todos que têm acesso ao seu projeto do Google Cloud . No entanto, os papéis do IAM do principal determinam se a consulta pode ser executada e os dados que ela retorna.

Console

Ao resolver um problema ou quando você encontra resultados anômalos, talvez queira compartilhar uma consulta e os resultados dela com um colega de equipe. Ao visualizar os resultados da consulta na página Análise de dados de registros, é possível copiar um URL que, quando aberto, mostra a consulta executada e os resultados dela.

Para compartilhar uma consulta e os resultados com um colega de equipe, faça o seguinte:

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

   Acesse Análise de registros

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

2. Preencha o painel Consulta com uma consulta e clique em Executar consulta.

   Para preencher o painel Consulta, insira uma nova consulta, selecione uma na guia Recente ou na guia Salvas.

3. Clique em Compartilhar link.

4. Envie o link para seu colega de equipe.

   Quando seu colega de equipe abre o link, a página Análise de dados de registros é aberta e mostra, mas não executa, a consulta. Seu colega de equipe precisa executar a consulta manualmente.

   A página Análise de dados de registros mostra uma caixa de diálogo de aviso quando a consulta é executada no mecanismo do BigQuery e os recursos consultados não estão no mesmo limite de propriedade. Os limites de propriedade são determinados por vários fatores, um deles é a hierarquia dos recursos usados pela consulta.

   Para abrir o URL, o papel do IAM do seu colega de equipe no projeto Google Cloud precisa incluir as permissões necessárias para acessar a página Análise de Registros.

Ver e executar consultas recentes ou salvas

Para ver ou executar uma consulta novamente, selecione a guia Recente na página Análise de dados de registros e encontre a consulta:

• Para executar a consulta, clique em Executar.
• Para ver a consulta, use as opções no menu Mais opções.

Para ver, editar ou executar uma consulta salva, selecione a guia Salvas na página Análise de dados de registros e encontre a consulta:

• Para executar a consulta, clique em Executar.
• Para editar, visualizar ou excluir a consulta, use as opções no menu Mais opções.

A seguir

• Representar os resultados da consulta SQL em um gráfico.
• Exemplos de consultas SQL.