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

Neste documento, descrevemos como criar, gerenciar e consultar visualizações de análise. Para uma visão geral conceitual, consulte Sobre as visualizações de análise.

Antes de começar

Como as visualizações de análise consultam visualizações de registros, para criar e consultar visualizações de análise, suas funções do IAM também precisam permitir que você consulte visualizações de registros e use a Análise de registros. Esta seção lista as funções do IAM necessárias para criar visualizações de análise e aquelas necessárias para consultar visualizações de registros e usar a Análise de registros:

• 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ê o papel do IAM de Usuário da análise de observabilidade (roles/observability.analyticsUser) no seu projeto.

  Esse papel predefinido contém as permissões necessárias para criar, gerenciar e usar visualizações de análise. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

  Permissões necessárias

  As seguintes permissões são necessárias para criar, gerenciar e usar visualizações de análise:

  • observability.analyticsViews.get
  • observability.analyticsViews.list
  • observability.analyticsViews.create
  • observability.analyticsViews.update
  • observability.analyticsViews.delete

• Para ter as permissões necessárias para consultar uma visualização de registros e usar o Log Analytics, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

  • Para consultar os buckets de registros _Required e _Default: Visualizador de registros (roles/logging.viewer)
  • Para consultar todas as visualizações de registros em um projeto: Acessador de visualizaçã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 de função de visualizador 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. Para mais informações, consulte 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.

Criar uma visualização de análise

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. No menu Visualizações, acesse a seção Registros do segmento e selecione a visualização de registros para consultar.

   Para encontrar uma visualização de registros, use a barra filter_list Filtrar ou role a lista de visualizações de registros. Cada entrada na lista está no seguinte formato: BUCKET_ID.LOG_VIEW_ID, em que esses campos se referem aos IDs do bucket de registros e da visualização de registros.

3. Na barra de ferramentas Esquema, clique em Consulta.

   O painel Consulta é atualizado com uma consulta SQL.

4. Verifique se a barra de ferramentas mostra Executar consulta.

   Se a barra de ferramentas mostrar Executar no BigQuery, clique em settings Configurações e selecione Análise de registros (padrão).

5. Atualize a consulta SQL no painel Consulta até ficar satisfeito com os resultados.

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

7. Insira um nome e uma descrição para a visualização de análise e clique em Salvar.

   O nome tem um limite de 100 caracteres e só pode incluir letras, dígitos, sublinhados e hífens.

   Sua vista do Google Analytics é criada e listada no painel Vistas, na seção data_table Vistas do Google Analytics. Cada entrada na lista está no seguinte formato: LOCATION.ANALYTICS_VIEW_ID, em que esses campos se referem ao local e ao ID de uma visualização do Google Analytics. Por exemplo, se você criou uma visualização do Google Analytics chamada my-analytic-view que consulta uma visualização de registros cujo bucket de registros está na região global, esta seção vai mostrar global.my-analytic-view.

Consultar uma visualização de análise

Depois que uma visualização de análise é criada, é possível consultá-la da mesma forma que uma visualização de registros. Para uma lista de documentos que descrevem como usar a página Análise de registros, consulte a seção Próximas etapas deste documento.

Para executar a consulta padrão de uma visualização 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. Insira uma consulta ou carregue a consulta padrão para a visualização do Google Analytics. A cláusula FROM da consulta precisa ter o seguinte formato:

   FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`
   

   Na expressão anterior, os campos têm o seguinte significado:

   • PROJECT_ID: o identificador do projeto.
   • LOCATION: o local da visualização de análise. O local de uma visualização do Google Analytics é herdado do recurso que ela consulta. Por exemplo, se uma vista do Google Analytics consultar uma vista de registro que está no local global, o local da vista do Google Analytics também será global.
   • 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 executar a consulta padrão, faça o seguinte:

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

      Para encontrar uma vista do Google Analytics, use a barra filter_list Filtrar ou role a lista de vistas do Google Analytics. Cada entrada na lista está no seguinte formato: LOCATION.ANALYTICS_VIEW_ID, em que esses campos se referem ao local e ao ID de uma visualização do Google Analytics.

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

      O painel Consulta é atualizado com uma consulta SQL que está consultando a visualização de análise selecionada.

3. Clique em Executar consulta.

   Se a barra de ferramentas mostrar Executar no BigQuery, clique em settings Configurações e selecione Análise de registros (padrão).

Listar visualizações de análise

Para listar as visualizações de análise no seu projeto 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. No menu Visualizações, acesse a seção data_table Visualizações do Analytics.

   Uma lista de vistas do Google Analytics é mostrada. Cada entrada na lista está no formato LOCATION.ANALYTICS_VIEW_ID, em que esses campos se referem ao local e ao ID de uma visualização do Google Analytics. Por exemplo, se você criou uma visualização do Google Analytics chamada my-analytic-view que consulta uma visualização de registros cujo bucket de registros está na região global, esta seção vai mostrar global.my-analytic-view.

3. Para conferir os detalhes de uma visualização de análise específica, faça o seguinte:

   1. Selecione a visualização do Google Analytics.

      O esquema da visualização de análise é mostrado na seção Esquema.

   2. Na barra de ferramentas Esquema, clique em more_vert Ver opções de visualização de análise e selecione Ver detalhes.

      A caixa de diálogo mostra informações sobre a vista do Google Analytics, incluindo quando ela foi criada, o esquema e a consulta.

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. No menu Vistas, acesse a seção data_table Vistas do Google Analytics e selecione a vista que você quer consultar.

3. Na barra de ferramentas Esquema, clique em more_vert 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 de análise. É possível modificar a descrição e a consulta.

4. Depois de fazer as modificações, clique em Substituir a visualização salva.

Excluir uma visualização de análise

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. No menu Vistas, acesse a seção data_table Vistas do Google Analytics e selecione a vista que você quer consultar.
3. Na barra de ferramentas Esquema, clique em more_vert 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 do Google Analytics não pode consultar outra.
• Uma visualização do Google Analytics pode consultar várias visualizações de registros. No entanto, os buckets de registros que hospedam as visualizações de registros consultadas precisam estar em um local. Por exemplo, suponha que você tenha dois buckets de registros, um em us-east1 e outro em asia-east1. Não é possível criar uma visualização de análise que consulte visualizações de registros nesses buckets.
• O recurso pai de uma visualização de análise precisa ser um projeto do Google Cloud . Não é possível criar uma vista do Google Analytics em pastas ou organizações.
• Não há suporte para conjuntos de dados vinculados em visualizações de análise. Portanto, só é possível consultar as visualizações de análise usando a página Análise de dados de registros. Além disso, é necessário executar essas consultas no serviço padrão do Cloud Logging.
• Não há suporte de API para criar ou gerenciar visualizações de análise.

• Os seguintes limites se aplicam às visualizações de análise:

  • Número máximo de visualizações do Google Analytics por projeto: 100 Google Cloud
  • Por projeto do Google Cloud , o número máximo de visualizações de análise por região é 50.
  • Por projeto do Google Cloud , o número máximo de regiões que podem armazenar visualizações de análise é 10.

A seguir

• Visão geral sobre consulta e análise de registros
• Salvar e compartilhar uma consulta SQL
• Criar gráficos com os resultados da consulta SQL
• Exemplos de consultas SQL