Criar, consultar e gerenciar visualizações de análise

Visualizar

Esse produto ou recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos gerais de serviço" dos Termos específicos de serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Este documento descreve como criar e gerenciar visualizações de análise. Depois de criar uma visualização de análise, você pode consultá-la de maneira semelhante a como consulta visualizações de observabilidade.

Para uma visão geral das visualizações de análise, consulte Sobre as visualizações de análise.

Antes de começar

Faça login nasua Google Cloud conta. Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho dos 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.

Enable the Observability API.

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

Enable the Observability API.

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 API

1. Para receber as permissões necessárias para criar, gerenciar e usar visualizações de análise, peça ao administrador que conceda 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 às 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 de análise de observabilidade (roles/observability.analyticsUser) no seu projeto. Esse papel contém as permissões necessárias para salvar e executar consultas particulares e executar consultas compartilhadas.
   • Leitor de registros (roles/logging.viewer) 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 usando personalizados papéis ou outros predefinidos papéis.

2. Verifique se você tem uma visualização de observabilidade. Para saber mais, consulte Modelo de armazenamento do Cloud Trace.

Criar uma visualização de análise

Observação: uma visualização de análise pode consultar visualizações de observabilidade. Quando uma visualização de análise consulta várias visualizações, elas precisam estar no mesmo local.

Para criar uma visualização de análise, faça o seguinte:

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

   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. Configure a página Análise de observabilidade :
   1. Verifique se a barra de ferramentas mostra Executar consulta. Se a barra de ferramentas mostrar Executar no BigQuery, então clique Configurações e selecione Análise de observabilidade (padrão).
   2. Se o menu Visualizações não for mostrado, acesse o painel de navegação e clique em Visualizações e esquema.

3. Insira e valide a consulta que você quer salvar como uma visualização de análise.

   Talvez você queira carregar e editar a consulta padrão da visualização de observabilidade que sua visualização de análise vai consultar. Para carregar a consulta padrão, faça o seguinte:

   1. No menu Visualizações, acesse a seção Traces, e selecione _Trace.Spans._AllSpans.

   2. Na barra de ferramentas Esquema , clique em Consulta e em Substituir.

      O painel Consulta é atualizado com uma consulta SQL.

   3. Atualize a consulta até ficar satisfeito com os resultados.

4. Criar uma visualização de análise:

   1. Na barra de ferramentas, clique em save Salvar e selecione Salvar como visualização de análise.

   2. Insira um nome e uma descrição para a visualização de análise.

      O nome é limitado a 100 caracteres e só pode incluir letras, números, sublinhados e hífens. Não é possível mudar o nome depois de criar a visualização de análise.

   3. Clique em Salvar.

   O sistema cria a visualização de análise e a lista no painel Visualizações, na seção data_table Visualizações de análise.

Consultar uma visualização de análise

Você consulta uma visualização de análise de maneira análoga à consulta de visualizações de observabilidade. Para consultar visualizações de análise, use o seguinte formato para a cláusula FROM:

FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`

Os campos nas expressões anteriores têm o seguinte significado:

• PROJECT_ID: o identificador do projeto.
• LOCATION: o local da visualização de análise.
• ANALYTICS_VIEW_ID: o ID da visualização de análise, que é limitado a 100 caracteres e só pode incluir letras, números, sublinhados e hífens.

Para saber mais, consulte Consultar e analisar traces.

Listar visualizações de análise

Para listar as visualizações de análise no seu Google Cloud projeto, faça o seguinte:

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

   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. Configure a página Análise de observabilidade :
   1. Verifique se a barra de ferramentas mostra Executar consulta. Se a barra de ferramentas mostrar Executar no BigQuery, então clique Configurações e selecione Análise de observabilidade (padrão).
   2. Se o menu Visualizações não for mostrado, acesse o painel de navegação e clique em Visualizações e esquema.

3. No menu Visualizações, acesse a seção data_table Visualizações de análise.

Receber detalhes sobre uma visualização de análise

Você pode usar as opções no painel Esquema para mostrar as seguintes informações sobre uma visualização de análise:

• Nome
• Data de criação
• Última atualização
• Esquema
• Consulta

Para conferir os detalhes de uma visualização de análise, liste as visualizações de análise no seu projeto e faça o seguinte:

1. Selecione a visualização de análise sobre a qual você quer ver informações.
2. Na barra de ferramentas Esquema clique em Exibir opções de visualização de análise, e selecione Ver detalhes.

Modificar uma visualização de análise

Para modificar uma visualização de análise, faça o seguinte:

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

   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. Configure a página Análise de observabilidade :
   1. Verifique se a barra de ferramentas mostra Executar consulta. Se a barra de ferramentas mostrar Executar no BigQuery, então clique Configurações e selecione Análise de observabilidade (padrão).
   2. Se o menu Visualizações não for mostrado, acesse o painel de navegação e clique em Visualizações e esquema.

3. No menu Visualizações, acesse a seção data_table Visualizações de análise e selecione a visualização de análise que você quer modificar.

4. Na barra de ferramentas Esquema, clique em Exibir opções de visualização de análise, e selecione Visualização de edição.

   Uma caixa de diálogo é aberta mostrando informações sobre a visualização de análise. Você pode modificar a descrição e a consulta.

5. Depois de concluir as modificações, clique em Substituir visualização salva.

Excluir uma visualização de análise

**Observação**: se você tiver escrito consultas em uma visualização de análise e excluir a visualização de análise, essas consultas vão falhar.

Para excluir uma visualização de análise, faça o seguinte:

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

   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. Configure a página Análise de observabilidade :
   1. Verifique se a barra de ferramentas mostra Executar consulta. Se a barra de ferramentas mostrar Executar no BigQuery, então clique Configurações e selecione Análise de observabilidade (padrão).
   2. Se o menu Visualizações não for mostrado, acesse o painel de navegação e clique em Visualizações e esquema.

3. No menu Visualizações, acesse a seção data_table Visualizações de análise e selecione a visualização de análise que você quer excluir.
4. Na barra de ferramentas Esquema, clique em Exibir opções de visualização de análise, selecione Excluir visualização e conclua a caixa de diálogo.

Limitações

As seguintes limitações se aplicam às visualizações de análise:

• Uma visualização de análise só pode consultar visualizações de observabilidade.
• O recurso pai de uma visualização de análise precisa ser um Google Cloud projeto.
• Só é possível consultar uma visualização de análise usando a página Análise de observabilidade e somente quando você usa o mecanismo de consulta Análise de observabilidade (padrão).
• Todas as visualizações que uma visualização de análise consulta precisam estar no mesmo local.
• Você precisa usar o Google Cloud console para criar ou gerenciar suas visualizações de análise.
• É possível criar no máximo 100 visualizações de análise por Google Cloud projeto.
• É possível criar no máximo 50 visualizações de análise por região.
• Por Google Cloud projeto, no máximo 10 regiões podem conter uma visualização de análise.

A seguir

• Consultar e analisar traces.
• Representar os resultados da consulta SQL em um gráfico.
• Salve e compartilhe consultas.
• Consultas SQL de amostra.