Sobre as vistas de análise

Este documento descreve as visualizações de análise e quando é recomendável criá-las. Ele também descreve as diferenças entre as visualizações do Google Analytics e as consultas salvas.

Visão geral

Uma visualização do Google Analytics é um recurso que pode ser consultado. Ou seja, depois de definir uma visualização de análise, você pode escrever consultas especificando sua visualização de análise na cláusula FROM.

O principal benefício de usar visualizações de análise é que você não precisa consultar os dados no formato definido por uma API ou um sistema. Com uma vista de análise, é possível definir um esquema para simplificar as consultas ou reduzir o tempo gasto escrevendo-as. A consulta em uma visualização do Google Analytics pode fazer coisas como reter apenas campos específicos, renomear campos, mover campos aninhados para uma coluna de nível superior e realizar agrupamentos e agregações.

As visualizações do Google Analytics não são visualizações materializadas. Uma visualização de análise não é uma visualização pré-calculada que armazena em cache os resultados da consulta periodicamente. Portanto, consultar uma visualização do Google Analytics é equivalente a consultar as visualizações listadas na consulta da visualização do Google Analytics.

As visualizações do Analytics são mais eficientes do que as consultas salvas, que são consultas executadas na página Análise de dados de registros e salvas. É possível executar novamente uma consulta salva, mas não consultar os resultados dela.

Tipos de vistas do Google Analytics

Há dois tipos de visualizações de análise: definidas pelo usuário e definidas pelo sistema:

As visualizações de análise definidas pelo usuário são aquelas que você cria. É possível consultar, editar e excluir visualizações de análise definidas pelo usuário.
As visualizações de análise definidas pelo sistema são criadas pelos serviços doGoogle Cloud . É possível consultar visualizações de análise definidas pelo sistema. No entanto, não é possível editar ou excluir esses dados.

Para informações sobre como listar as visualizações do Analytics no seu projetoGoogle Cloud , consulte Listar visualizações do Analytics.

Local das visualizações de análise de dados

O local de uma visualização do Google Analytics é determinado pelo local dos recursos que ela consulta. Por exemplo, se uma visualização de análise consultar uma visualização de capacidade de observação no local global, o local da visualização de análise também precisará ser global. Quando você usa o console Google Cloud para criar uma vista de análise, o local é definido automaticamente.

Exemplos de casos de uso

O principal benefício de uma vista de análise é que você não precisa consultar os dados no formato definido pelo sistema. Com uma vista de análise, é possível definir um esquema para simplificar as consultas ou reduzir o tempo gasto escrevendo-as.

Extrair nome do serviço de rastreamento

Suponha que você queira escrever consultas que analisem seus dados de rastreamento e queira mostrar ou agrupar por um nome de serviço sintetizado. A consulta para sua visualização de análise determina o nome do serviço de um intervalo usando a função COALESCE, que avalia uma lista de expressões em ordem e retorna o valor da primeira expressão que não é avaliada como NULL:

SELECT
  start_time,
  -- Set the value of service name based on the first non-null value in the list.
  COALESCE(
    JSON_VALUE(resource.attributes, '$."service.name"'),
    JSON_VALUE(attributes, '$."service.name"'),
    JSON_VALUE(attributes, '$."g.co/gae/app/module"')) AS service_name,
  name AS span_name,
  duration_nano,
  status.code AS status,
  trace_id,
  span_id
FROM
  `PROJECT_ID.us._Trace.Spans._AllSpans`
LIMIT 10

Antes de usar a consulta, substitua PROJECT_ID pelo ID do seu projetoGoogle Cloud .

Limitações

As seguintes limitações se aplicam às visualizações de análise:

Uma vista de análise só pode consultar vistas de observabilidade.
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 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 visualização de análise.