Sobre as vistas de análise

Com as visualizações de análise no Análise de Observabilidade, é possível definir uma consulta SQL com um esquema personalizado nos seus dados de observabilidade para simplificar e reutilizar transformações complexas. Enquanto só é possível executar novamente uma consulta salva, você pode referenciar uma visualização de análise como uma fonte de dados na cláusula FROM de outras consultas SQL.

Visão geral

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

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

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 periodicamente os resultados da consulta. Portanto, consultar uma visualização de análise é equivalente a consultar as visualizações listadas na consulta da visualização de análise.

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

Tipos de visualizações 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 Google Cloud . É possível consultar visualizações de análise definidas pelo sistema. No entanto, não é possível editar ou excluir esses itens.

Para informações sobre como listar as visualizações de análise no seu projetoGoogle Cloud , consulte Listar visualizações de análise.

Local das visualizações de análise

O local de uma visualização de análise é determinado pela localização dos recursos que ela consulta. Por exemplo, se uma visualização de análise consultar uma visualização de observabilidade 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 visualização de análise, o local é definido automaticamente.

Exemplos de casos de uso

Os exemplos a seguir ilustram como usar visualizações de análise para simplificar e reutilizar consultas.

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 período 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 projeto do Google Cloud .

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 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 observabilidade e somente quando você usa o mecanismo de consulta Análise de observabilidade (padrão).
  • Todas as visualizações de análise consultadas por uma visualização de análise 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 de análise por projeto do Google Cloud .
  • É possível criar no máximo 50 visualizações de análise por região.
  • Por projeto do Google Cloud Analytics, no máximo 10 regiões podem conter uma visualização de análise.

A seguir