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

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

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

Antes de começar

Observação :não há papéis predefinidos do Identity and Access Management (IAM) do Cloud Logging que contenham as permissões necessárias para criar ou consultar uma visualização de análise.

Como as visualizações de análise consultam visualizações de registro, para criar e consultar visualizações de análise, suas funções do IAM também precisam permitir que você consulte visualizações de registro e use a Análise de Registros. Esta seção lista os papéis do IAM necessários para criar visualizações de análise e aqueles necessários para consultar visualizações de registro 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 de 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 permissões a seguir 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 registro e usar a Análise de registros, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

  • Para consultar os buckets de registro _Required e _Default: Visualizador de registros (roles/logging.viewer)
  • Para consultar todas as visualizações de registro em um projeto: Acessador de visualização de registros (roles/logging.viewAccessor)

  É possível restringir um principal a uma visualização de registro específica adicionando uma condição do IAM à concessão de função de acessador da visualização 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

Observação: uma visualização de análise só pode consultar visualizações de registro. Quando várias visualizações de registro são consultadas, os buckets de registro que hospedam essas visualizações precisam estar em um local. Por exemplo, se você tiver dois buckets de registro no local us-east1, crie uma visualização de análise que consulte as visualizações de registro nesses buckets.

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

1. No console do 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 Views, acesse a seção segment Logs e selecione a visualização de registro a ser consultada.

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

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 Run in BigQuery, clique em Settings e selecione Log Analytics (default).

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

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

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

   O nome é limitado a 100 caracteres e pode incluir apenas letras, números, sublinhados e hifens.

   Observação: não é possível mudar o nome de uma visualização de análise depois que ela é criada. É possível modificar a descrição e a consulta.

   Sua vista de análise é criada e listada no painel Views, na seção data_table Vistas de análise. 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 de análise. Por exemplo, se você criou uma visualização de análise com o nome my-analytic-view que consulta uma visualização de registro cujo bucket está na região global, essa 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 de forma semelhante a uma visualização de registro. Para conferir uma lista de documentos que descrevem como usar a página da Análise de registros, consulte a seção O que vem a seguir deste documento.

Para executar a consulta padrão de uma visualização de análise, faça o seguinte:

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

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

      Para encontrar uma vista de análise, use a barra Filtro ou role a lista de vistas de análise. 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 de análise.

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

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

3. Clique em Executar consulta.

   Se a barra de ferramentas mostrar Run in BigQuery, clique em Settings e selecione Log Analytics (default).

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 do 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 de análise.

   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 de análise. Por exemplo, se você criou uma visualização de análise com o nome my-analytic-view que consulta uma visualização de registro cujo bucket está na região global, essa 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 de análise.

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

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

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

Modificar uma visualização de análise

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

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

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

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

4. Depois de fazer 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 essa visualização, essas consultas vão falhar.

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

1. No console do 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 Views, acesse a seção Vistas do Google Analytics data_table e selecione a que você quer consultar.
3. Na barra de ferramentas Esquema, clique em Ver 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 não pode consultar outra.
• Uma visualização de análise pode consultar várias visualizações de registro. No entanto, os buckets de registro que hospedam as visualizações de registro consultadas precisam estar em um local. Por exemplo, suponha que você tenha dois buckets de registro, 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 visualização de análise em pastas ou organizações.
• Os conjuntos de dados vinculados não são compatíveis com as visualizações do Google Analytics. Portanto, só é possível consultar 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 limites a seguir se aplicam às visualizações de análise:

  • Número máximo de visualizações do Google Analytics por projeto do Google Cloud: 100
  • Por projeto do Google Cloud, o número máximo de visualizações do Google Analytics 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 de consulta e análise de registros
• Salvar e compartilhar uma consulta SQL
• Gráfico de resultados da consulta SQL
• Exemplos de consultas SQL