Crie, consulte e faça a gestão de vistas de estatísticas

Pré-visualização

Este produto ou funcionalidade está sujeito aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. Os produtos e as funcionalidades pré-GA estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Este documento descreve como criar e gerir visualizações de propriedades do Analytics. Depois de criar uma visualização de propriedade do Analytics, pode consultá-la de forma semelhante à consulta de visualizações de registos. Se não conhece as visualizações de propriedades do Analytics, consulte o artigo Acerca das visualizações de propriedades do Analytics.

Antes de começar

1. Verify that billing is enabled for your Google Cloud project.

2. Para receber as autorizações de que precisa para criar, gerir e usar vistas de analytics, peça ao seu administrador que lhe conceda as seguintes funções de IAM no seu projeto:

   • Utilizador de estatísticas de observabilidade (roles/observability.analyticsUser)
   • Aceder à vista de registos (roles/logging.viewAccessor)

   Pode restringir um principal a uma vista de registos específica adicionando uma condição de IAM à concessão da função Logs View Accessor feita ao nível do projeto ou adicionando uma associação de IAM ao ficheiro de política da vista de registos. Para mais informações, consulte o artigo Controle o acesso a uma vista de registo.

   Para ver informações sobre funções adicionais necessárias para consultar visualizações em contentores definidos pelo utilizador ou para consultar a visualização _AllLogs do contentor de registos _Default, consulte as funções do Cloud Logging.

3. Certifique-se de que tem um contentor de registos atualizado para usar o Log Analytics. Para obter informações sobre este passo, consulte o artigo Configure contentores de registo.

Crie uma vista do Analytics

Nota: uma vista de estatísticas pode consultar visualizações de registos. Quando uma visualização de propriedade do Analytics consulta várias visualizações de propriedade, estas têm de estar na mesma localização. Por exemplo, se tiver dois contentores de registos na localização us-east1, pode criar uma visualização de propriedade do Analytics que consulte visualizações de registos nesses dois contentores de registos.

Para criar uma vista de estatísticas, faça o seguinte:

1. Na Google Cloud consola, aceda à página Log Analytics:

   Aceda ao Log Analytics

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda é Registo.

2. Configure a página Log Analytics:
   1. Certifique-se de que a barra de ferramentas apresenta a opção Executar consulta. Se a barra de ferramentas apresentar Executar no BigQuery, clique em Definições e selecione Log Analytics (predefinição).
   2. Se o menu Vistas não for apresentado, aceda ao painel de navegação e clique em Vistas e esquema.

3. Introduza e valide a consulta que quer guardar como uma vista de estatísticas.

   Pode querer carregar e editar a consulta predefinida para a vista de registo que a sua vista de estatísticas vai consultar. Para carregar a consulta predefinida, faça o seguinte:

   1. No menu Visualizações, aceda à secção segment Registos, localize e, de seguida, selecione a visualização de registos que quer consultar.

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

      O painel Consulta é atualizado com uma consulta SQL.

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

4. Crie uma vista de análise:

   1. Na barra de ferramentas, clique em Guardar Guardar e, de seguida, selecione Guardar como vista de análise.

   2. Introduza um nome e uma descrição para a vista do Analytics.

      O nome está limitado a 100 carateres e só pode incluir letras, dígitos, sublinhados e hífenes. Não pode alterar o nome depois de criar a vista de estatísticas.

   3. Clique em Guardar.

   O sistema cria a sua visualização de propriedade do Analytics e apresenta-a no painel Visualizações de propriedade, na secção data_table Visualizações de propriedade do Analytics.

Consultar uma visualização de propriedade do Google Analytics

Consulta uma visualização de estatísticas de uma forma análoga à consulta de visualizações de registos. Para consultar vistas 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: a localização da vista de estatísticas.
• ANALYTICS_VIEW_ID: O ID da visualização de estatísticas, que está limitado a 100 carateres e só pode incluir letras, dígitos, sublinhados e hífenes.

Para saber mais, consulte o artigo Consultar e analisar vista geral dos registos.

Liste as visualizações de propriedade do Analytics

Para listar as vistas de estatísticas no seu Google Cloud projeto, faça o seguinte:

1. Na Google Cloud consola, aceda à página Log Analytics:

   Aceda ao Log Analytics

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda é Registo.

2. Configure a página Log Analytics:
   1. Certifique-se de que a barra de ferramentas apresenta a opção Executar consulta. Se a barra de ferramentas apresentar Executar no BigQuery, clique em Definições e selecione Log Analytics (predefinição).
   2. Se o menu Vistas não for apresentado, aceda ao painel de navegação e clique em Vistas e esquema.

3. No menu Vistas, aceda à secção data_table Vistas do Analytics.

Veja detalhes acerca de uma vista do Analytics

Pode usar as opções no painel Esquema para apresentar as seguintes informações acerca de uma vista do Analytics:

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

Para ver os detalhes de uma vista de estatísticas, liste as vistas de estatísticas no seu projeto e, em seguida, faça o seguinte:

1. Selecione a visualização de propriedade do Analytics cujas informações quer ver.
2. Na barra de ferramentas Esquema clique em Ver opções de visualização de estatísticas e selecione Ver detalhes.

Modifique uma vista do Analytics

Para modificar uma vista de estatísticas, faça o seguinte:

1. Na Google Cloud consola, aceda à página Log Analytics:

   Aceda ao Log Analytics

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda é Registo.

2. Configure a página Log Analytics:
   1. Certifique-se de que a barra de ferramentas apresenta a opção Executar consulta. Se a barra de ferramentas apresentar Executar no BigQuery, clique em Definições e selecione Log Analytics (predefinição).
   2. Se o menu Vistas não for apresentado, aceda ao painel de navegação e clique em Vistas e esquema.

3. No menu Visualizações, aceda à secção data_table Visualizações do Analytics e selecione a visualização do Analytics que quer modificar.

4. Na barra de ferramentas Esquema, clique em Ver opções de visualização de estatísticas, e selecione Editar visualização.

   É aberta uma caixa de diálogo que apresenta informações sobre a vista de estatísticas. Pode modificar a descrição e a consulta.

5. Depois de concluir as modificações, clique em Substituir vista guardada.

Elimine uma visualização do Analytics

Nota: se tiver escrito consultas em relação a uma visualização de propriedade do Analytics e eliminar essa visualização de propriedade do Analytics, essas consultas vão falhar.

Para eliminar uma vista do Analytics, faça o seguinte:

1. Na Google Cloud consola, aceda à página Log Analytics:

   Aceda ao Log Analytics

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda é Registo.

2. Configure a página Log Analytics:
   1. Certifique-se de que a barra de ferramentas apresenta a opção Executar consulta. Se a barra de ferramentas apresentar Executar no BigQuery, clique em Definições e selecione Log Analytics (predefinição).
   2. Se o menu Vistas não for apresentado, aceda ao painel de navegação e clique em Vistas e esquema.

3. No menu Visualizações, aceda à secção data_table Visualizações do Analytics e selecione a visualização do Analytics que quer eliminar.
4. Na barra de ferramentas Esquema, clique em Ver opções de visualização de estatísticas, selecione Eliminar vista e conclua a caixa de diálogo.

Limitações

As seguintes limitações aplicam-se às vistas de estatísticas:

• Uma visualização do Analytics só pode consultar visualizações de registos.
• O recurso principal de uma vista do Analytics tem de ser um Google Cloud projeto.
• Só pode consultar uma vista do Analytics através da página Log Analytics e apenas quando usa o motor de consulta Log Analytics (predefinição).
• Todas as vistas que uma vista do Analytics consulta têm de estar na mesma localização.
• Tem de usar a Google Cloud consola para criar ou gerir as suas vistas do Analytics.
• Pode criar, no máximo, 100 visualizações de propriedade do Analytics por Google Cloud projeto.
• Pode criar, no máximo, 50 visualizações de propriedade do Google Analytics por região.
• Por Google Cloud projeto, no máximo, 10 regiões podem conter uma vista de estatísticas.

O que se segue?

• Vista geral da consulta e análise de registos
• Guarde e partilhe uma consulta SQL
• Represente graficamente os resultados de consultas SQL
• Exemplos de consultas SQL