Sobre as visualizações de análise

Este documento descreve as visualizações de análise e quando é recomendável criá-las. Também descreve as diferenças entre as visualizações de análise e conceitos que você já conhece, como consultas salvas e visualizações de registros.

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, é possível escrever consultas em que você especifica 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 Google Analytics são mais eficientes do que as consultas salvas, que são consultas executadas na página Log Analytics 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 do Google 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 vista do Google Analytics consultar uma vista de registros que está no local global, o local da vista do Google Analytics 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.

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 as consultas de análise, crie a seguinte vista 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 hifens.

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 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 do Google Analytics 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 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 vista de análise.

A seguir