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

Pré-lançamento

Este produto ou recurso está sujeito aos "Termos das Soluções 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 assistência limitada. Para mais informações, consulte as descrições das fases de lançamento.

Neste documento, descrevemos como criar e gerenciar visualizações de análise. Depois de criar uma visualização de análise, é possível consultá-la de maneira semelhante à consulta de visualizações de registros e 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 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 criar, gerenciar e usar visualizações de análise, 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. É possível restringir essa concessão de função a uma visualização específica adicionando uma condição 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 usando papéis personalizados ou outros papéis predefinidos.

2. Verifique se você tem pelo menos uma das seguintes opções:
   • Um bucket de registros que foi atualizado para usar a Análise de dados de registros. Para mais informações, consulte Configurar buckets de registros.
   • 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 registros e de observabilidade. Quando uma visualização do Google Analytics consulta várias visualizações, elas precisam estar no mesmo local. Por exemplo, se você tiver dois buckets de registros no local us-east1, poderá criar uma visualização de análise que consulte as visualizações de registros nesses dois buckets.

Para criar uma visualização de análise, 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. Configure a página Análise de dados de registros:
   1. Verifique se a barra de ferramentas mostra Executar consulta. Se a barra de ferramentas mostrar Executar no BigQuery, clique em Configurações e selecione Análise de dados de registros (padrão).
   2. Se o menu Visualizações não aparecer, 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 para a visualização de registros ou de observabilidade que sua visualização do Google Analytics vai consultar. Para carregar a consulta padrão, faça o seguinte:

   1. No menu Visualizações, faça uma das seguintes ações:

      • Acesse a seção segmento Registros e selecione uma visualização de registros.
      • Acesse a seção Rastreamentos 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. Crie uma visualização de análise:

   1. Na barra de ferramentas, clique em Salvar Salvar e selecione Salvar como visualização do Google Analytics.

   2. Digite um nome e uma descrição para a visualização do Google Analytics.

      O nome tem um limite de 100 caracteres e só pode incluir letras, dígitos, 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 vista de análise e a lista no painel Vistas, na seção data_table Vistas 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 registros e de observabilidade. Para consultar visualizações de análise, use o seguinte formato na 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 do Google Analytics, que é limitado a 100 caracteres e pode incluir apenas letras, dígitos, sublinhados e hifens.

Para saber mais, consulte Análise de dados de registros.

Listar vistas de análise

Para listar as visualizações de análise no seu projeto do Google Cloud , 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. Configure a página Análise de dados de registros:
   1. Verifique se a barra de ferramentas mostra Executar consulta. Se a barra de ferramentas mostrar Executar no BigQuery, clique em Configurações e selecione Análise de dados de registros (padrão).
   2. Se o menu Visualizações não aparecer, 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 do Analytics.

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

Use as opções no painel Esquema para mostrar as seguintes informações sobre uma vista de análise:

• Nome
• Data de criação.
• Última atualização.
• Schema.
• Query.

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 do Google Analytics com as informações que você quer conferir.
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 vista do Google Analytics, 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. Configure a página Análise de dados de registros:
   1. Verifique se a barra de ferramentas mostra Executar consulta. Se a barra de ferramentas mostrar Executar no BigQuery, clique em Configurações e selecione Análise de dados de registros (padrão).
   2. Se o menu Visualizações não aparecer, acesse o painel de navegação e clique em Visualizações e esquema.

3. No menu Vistas, acesse a seção data_table Vistas do Google Analytics e selecione a vista que você quer modificar.

4. Na barra de ferramentas Esquema, clique em Ver opções de visualização do Google Analytics e selecione Editar visualização.

   Uma caixa de diálogo é aberta com informações sobre a visualização do Google Analytics. É possível 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 do Google Analytics e excluir essa visualização, as consultas vão falhar.

Para excluir uma visualização de análise, 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. Configure a página Análise de dados de registros:
   1. Verifique se a barra de ferramentas mostra Executar consulta. Se a barra de ferramentas mostrar Executar no BigQuery, clique em Configurações e selecione Análise de dados de registros (padrão).
   2. Se o menu Visualizações não aparecer, 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 do Google Analytics e selecione a visualização do Google Analytics que você quer excluir.
4. Na barra de ferramentas Esquema, clique em Ver opções de visualização de análise, selecione Excluir visualização e preencha 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 registros e de observabilidade.
• O recurso pai de uma visualização de análise precisa ser um projeto do Google Cloud .
• Só é possível consultar uma vista de análise usando a página Análise de registros e apenas quando você usa o mecanismo de consulta Análise de registros (padrão).
• Todas as visualizações consultadas por uma visualização do Google Analytics precisam estar no mesmo local.
• Você precisa usar o console do Google Cloud para criar ou gerenciar suas visualizações de análise.
• É possível criar no máximo 100 visualizações do Analytics por projeto do Google Cloud .
• É possível criar até 50 vistas de análise por região.
• Por projeto do Google Cloud , no máximo 10 regiões podem conter uma vista de análise.

A seguir

• Consultar e analisar a telemetria com a Análise de dados de registros.
• Representar os resultados da consulta SQL em um gráfico.
• Salve e compartilhe consultas.
• Exemplos de consultas SQL.