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

Visualizar

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 suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

As visualizações de análise na Análise de Observabilidade permitem definir uma consulta SQL com um esquema personalizado sobre os dados do Cloud Logging para simplificar e reutilizar transformações complexas. Depois de criar uma visualização de análise, é possível consultar os resultados dela na cláusula FROM de outras consultas SQL, assim como você consulta visualizações de registro.

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

Antes de começar

1. Verifique se o faturamento está ativado para o projeto do Google Cloud .

2. 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 no projeto:

   • Usuário da Análise de Observabilidade (roles/observability.analyticsUser)
   • Acessador de exibição de registros (roles/logging.viewAccessor)

   É possível restringir um principal a uma visualização de registros específica adicionando uma condição do IAM à concessão do papel de acessador de visualizações de registros feita no nível do projeto ou adicionando uma vinculação do IAM ao arquivo de política da visualização de registros. Saiba mais em Controlar o acesso a uma visualização de registro.

   Para informações sobre outros papéis necessários para consultar visualizações em buckets definidos pelo usuário ou para consultar a visualização _AllLogs do bucket de registros _Default, consulte Papéis do Cloud Logging.

3. Verifique se você tem um bucket de registros que foi atualizado para usar a Análise de Observabilidade. Para informações sobre essa etapa, consulte Configurar buckets de registros.

Criar uma visualização de análise

Observação :uma visualização de análise pode consultar visualizações de registros. Se uma visualização de análise consultar várias visualizações, elas precisarão 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 consulta 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 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. 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, clique em Configurações e selecione Análise de Observabilidade (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 da visualização de registro que será consultada pela visualização de análise. Para carregar a consulta padrão, faça o seguinte:

   1. No menu Visualizações, acesse a seção Registros do segmento, encontre e selecione a visualização de registro que você quer consultar.

   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é que os resultados sejam satisfatórios.

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

   1. Na barra de ferramentas, clique em salvar 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 pode incluir apenas letras, dígitos, sublinhados e hifens. 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 Visualizações de análise de data_table.

Consultar uma visualização de análise

Você consulta uma visualização de análise de maneira análoga à consulta de visualizações de registro. 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 pode incluir apenas letras, dígitos, sublinhados e hifens.

Para saber mais, consulte Visão geral de consulta e análise de registros.

Listar visualizações 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 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. 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, clique em Configurações e selecione Análise de Observabilidade (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 de análise.

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

Use as opções no painel Esquema para exibir 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 projeto e faça o seguinte:

1. Selecione a visualização de análise com as informações que você quer acessar.
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 console Google Cloud , 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. 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, clique em Configurações e selecione Análise de Observabilidade (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 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 com informações sobre a visualização de análise. É 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 de análise e excluí-la, essas 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 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. 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, clique em Configurações e selecione Análise de Observabilidade (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 de análise e selecione a visualização de análise 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 registro.
• O recurso pai de uma visualização de análise precisa ser um projeto do Google Cloud .
• 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 consultadas por uma visualização de análise precisam estar no mesmo local.
• Use o console do Google Cloud para criar ou gerenciar suas visualizações de análise.
• É possível criar no máximo 100 visualizações de análise por projeto do Google Cloud .
• É 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

• Visão geral sobre consulta e análise de registros
• Salvar e compartilhar uma consulta SQL
• Representar os resultados da consulta SQL em um gráfico
• Exemplos de consultas SQL