Sobre as vistas de análise

Este documento descreve as visualizações de análise e quando você pode querer criá-las. Ele também descreve as diferenças entre as visualizações de análise e as consultas salvas.

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 em que especifica a visualização de análise na cláusula FROM.

O principal benefício de usar visualizações de análise é que você não está restrito a consultar os dados no formato definido por uma API ou sistema. Uma visualização de análise permite definir um esquema, o que simplifica as consultas ou reduz o tempo gasto na criação delas. 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 de análise não são visualizações materializadas. Uma visualização de análise não é uma visualização pré-computada que armazena em cache os resultados da consulta periodicamente. 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 de análise são mais poderosas do que as consultas salvas, que são consultas executadas na página Análise de observabilidade e salvas. É possível executar uma consulta salva novamente, mas não é possível consultar os resultados de uma consulta salva.

Tipos de visualizações de análise

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 todas as visualizações de análise criadas por você. É 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 visualizações de análise criadas por Google Cloud serviços. É possível consultar visualizações de análise definidas pelo sistema. No entanto, não é possível editá-las ou excluí-las.

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

Localização das visualizações de análise

A localização de uma visualização de análise é determinada pela localização dos recursos que ela consulta. Por exemplo, se uma visualização de análise consultar uma visualização de observabilidade que esteja no local global, a localização da visualização de análise também precisará ser global. Quando você usa o Google Cloud console para criar uma visualização de análise, a localização é definida automaticamente.

Exemplos de casos de uso

O principal benefício de uma visualização de análise é que você não está restrito a consultar os dados no formato definido pelo sistema. Uma visualização de análise permite definir um esquema, o que simplifica as consultas ou reduz o tempo gasto na criação delas.

Extrair o nome do serviço de rastreamento

Suponha que você queira escrever consultas que analisem seus dados de rastreamento e queira exibir ou agrupar por um nome de serviço sintetizado. A consulta da 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 Google Cloud projeto.

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 Google Cloud projeto.
  • 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 consultadas por uma visualização de análise precisam estar no mesmo local.
  • É necessário usar o Google Cloud console para criar ou gerenciar as visualizações de análise.
  • É possível criar no máximo 100 visualizações de análise por Google Cloud projeto.
  • É possível criar no máximo 50 visualizações de análise por região.
  • Por Google Cloud projeto, no máximo 10 regiões podem conter uma visualização de análise.

A seguir