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 registros 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.
Consultar detalhes da rede
Você quer analisar a performance da rede usando os registros de fluxo de VPC. Você precisa analisar o desempenho 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 suas 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 registros.
- BUCKET_ID: o nome ou ID do bucket de registros.
- LOG_VIEW_ID: o identificador da visualização de registros, que é limitado a 100 caracteres e pode incluir apenas letras, dígitos, sublinhados e hífens.
Quando você quer analisar a performance da rede, consulta sua visualização de análise. Por exemplo, se você tiver interesse 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 básica para análise de latência da API
Várias equipes precisam de dados de performance semanais para concluir as análises. Em vez de cada equipe gerar os dados semanais, você cria uma visualização de análise que extrai esses dados. Outras equipes podem consultar a visualização de análise e fazer a própria 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 registros.
- 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
- Criar, consultar e gerenciar visualizações de análise
- Visão geral sobre consulta e análise de registros
- Salvar e compartilhar uma consulta SQL