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 Observability Analytics 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.

Local das visualizações de análise

O local de uma visualização de análise é determinado pelo local dos recursos 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 precisará ser global. Quando você usa o Google Cloud console para criar uma visualização de análise, o local é definido 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.

Consultar detalhes da rede

Você quer analisar a performance da rede usando os registros de fluxo de VPC. É necessário analisar a performance geral da rede e identificar redes, endereços IP e hosts específicos. Essas informações são armazenadas em campos aninhados no campo json_payload de uma entrada de registro.

Para simplificar as consultas de análise, crie a seguinte visualização de análise e nomeie-a como network_details:

SELECT
  -- Create a column for each network field.
  JSON_VALUE(resource.labels.subnetwork_name) subnetwork_name,
  JSON_VALUE(json_payload.src_instance.vm_name) vm_name,
  JSON_VALUE(json_payload.connection.src_ip) as src_ip,
  JSON_VALUE(json_payload.connection.src_port) as src_port,
  JSON_VALUE(json_payload.connection.dest_ip) as dest_ip,
  JSON_VALUE(json_payload.connection.dest_port) as dest_port,
  CAST(JSON_VALUE(json_payload.bytes_sent) as INT64) as bytes_sent,
  CAST(JSON_VALUE(json_payload.packets_sent) as INT64) as packets_sent
FROM
  -- Query one log view.
  `PROJECT_ID.LOCATION.BUCKET_ID.LOG_VIEW_ID`
WHERE
  -- Only query the VPC Flow Logs log.
  log_id = "compute.googleapis.com/vpc_flows"
  AND SEARCH(json_payload.reporter, "SRC")

Antes de usar a consulta, defina os valores das seguintes variáveis:

PROJECT_ID: o identificador do projeto.
LOCATION: o local da visualização de registro.
BUCKET_ID: o nome ou ID do bucket de registros.
LOG_VIEW_ID: o identificador da visualização de registro, que é limitado a 100 caracteres e pode incluir apenas letras, dígitos, sublinhados e hifens.

Quando quiser analisar a performance da rede, consulte a visualização de análise. Por exemplo, se você estiver interessado apenas no nome da instância e na quantidade de dados enviados, poderá escrever a seguinte consulta:

SELECT vm_name, bytes_sent, packets_sent,
FROM `analytics_view.my_project.global.network_details`
ORDER BY bytes_sent DESC
LIMIT 100

Consulta de base para análise de latência da API

Várias equipes precisam de dados de performance semanais para concluir a análise. Em vez de cada equipe gerar os dados semanais, você cria uma visualização de análise que extrai os dados semanais. Outras equipes podem consultar a visualização de análise e realizar a análise.

A consulta a seguir ilustra como usar o SQL para calcular a latência mínima, máxima e média da solicitação:

SELECT week, MIN(took_ms) as min, MAX(took_ms) AS max, AVG(took_ms) AS avg
FROM (
  SELECT TIMESTAMP_TRUNC(timestamp, WEEK) AS week,
  CAST( JSON_VALUE(json_payload, '$."http.resp.took_ms"') AS INT64) as took_ms
  FROM
    -- Query one log view.
    `PROJECT_ID.LOCATION.BUCKET_ID.LOG_VIEW_ID`
  WHERE json_payload IS NOT NULL
    AND SEARCH(labels,"frontend")
    AND JSON_VALUE(json_payload.message) = "request complete"
  ORDER BY took_ms DESC, timestamp ASC
)
GROUP BY week ORDER BY week

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 registro.
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 Observability Analytics e somente quando você usa o mecanismo de consulta Observability Analytics (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.