Acerca das visualizações de propriedades do Analytics

Este documento descreve as vistas de estatísticas e quando pode ser útil criá-las. Também descreve as diferenças entre as vistas de análise e os conceitos que pode conhecer, como as consultas guardadas e as vistas de registos.

Vista geral

Uma visualização de propriedade do Analytics é um recurso que pode consultar. Ou seja, depois de definir uma vista de análise, pode escrever consultas em que especifica a vista de análise na cláusula FROM.

A principal vantagem de usar vistas de análise é que não está limitado a consultar os dados no formato definido por uma API ou um sistema. Uma vista de análise permite-lhe definir um esquema, o que lhe permite simplificar as consultas ou reduzir o tempo que dedica a escrever consultas. A consulta numa vista de estatísticas pode fazer coisas como reter apenas campos específicos, mudar o nome dos campos, mover campos aninhados para uma coluna de nível superior e realizar agrupamentos e agregações.

As visualizações de propriedade do Analytics não são visualizações materializadas. Uma vista de estatísticas não é uma vista pré-calculada que armazena em cache periodicamente os resultados das consultas. Por conseguinte, consultar uma visualização de propriedade do Analytics é equivalente a consultar as visualizações de propriedade listadas na consulta da visualização de propriedade do Analytics.

As visualizações do Analytics são mais eficazes do que as consultas guardadas, que são consultas que executa na página Análise de registos e, em seguida, guarda. Pode executar novamente uma consulta guardada, mas não pode consultar os resultados de uma consulta guardada.

Tipos de visualizações de propriedade do Analytics

Existem dois tipos de vistas de estatísticas: definidas pelo utilizador e definidas pelo sistema:

  • As visualizações de propriedade do Analytics definidas pelo utilizador são quaisquer visualizações de propriedade do Analytics que criar. Pode consultar, editar e eliminar vistas de análise definidas pelo utilizador.

  • As visualizações de propriedade do Analytics definidas pelo sistema são visualizações de propriedade do Analytics criadas pelos Google Cloud serviços. Pode consultar vistas de análise definidas pelo sistema. No entanto, não pode editá-los nem eliminá-los.

Para obter informações sobre como listar as visualizações de propriedade do Analytics no seuGoogle Cloud projeto, consulte o artigo Liste as visualizações de propriedade do Analytics.

Localização das visualizações de propriedades do Analytics

A localização de uma visualização de propriedade do Analytics é determinada pela localização dos recursos que consulta. Por exemplo, se uma visualização de propriedade do Analytics consultar uma visualização de registo que se encontra na localização global, a localização da visualização de propriedade do Analytics também tem de ser global. Quando usa a Google Cloud consola para criar uma vista do Analytics, a localização é definida automaticamente.

Exemplos de utilização

A principal vantagem de uma visualização de análise é que não está limitado a consultar os dados no formato definido pelo sistema. Uma vista de análise permite-lhe definir um esquema, o que lhe permite simplificar as consultas ou reduzir o tempo que dedica a escrever consultas.

Consultar detalhes da rede

Quer analisar o desempenho da rede através dos registos de fluxo de VPC. Tem de analisar o desempenho geral da rede, bem como identificar redes, endereços IP e anfitriões específicos. Estas informações são armazenadas em campos aninhados no campo json_payload de uma entrada de registo.

Para simplificar as suas consultas de análise, cria a seguinte vista de análise e atribui-lhe o nome 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: a localização da vista de registo.
  • BUCKET_ID: o nome ou o ID do contentor de registos.
  • LOG_VIEW_ID: o identificador da vista de registo, que está limitado a 100 carateres e só pode incluir letras, dígitos, sublinhados e hífenes.

Quando quer analisar o desempenho da rede, consulta a vista do Analytics. Por exemplo, se só tiver interesse no nome da instância e na quantidade de dados enviados, pode 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 base para análise da latência da API

Várias equipas precisam de dados de desempenho semanais para concluir a respetiva análise. Em vez de cada equipa gerar os dados semanais, cria uma visualização de propriedade do Analytics que extrai os dados semanais. Outras equipas podem consultar a vista de estatísticas e, em seguida, fazer a respetiva análise.

A seguinte consulta ilustra como usar o SQL para calcular a latência mínima, máxima e média dos pedidos:

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 aplicam-se às vistas de estatísticas:

  • Uma visualização do Analytics só pode consultar visualizações de registos.
  • O recurso principal de uma vista do Analytics tem de ser um Google Cloud projeto.
  • Só pode consultar uma vista do Analytics através da página Log Analytics e apenas quando usa o motor de consulta Log Analytics (predefinição).
  • Todas as vistas que uma vista do Analytics consulta têm de estar na mesma localização.
  • Tem de usar a Google Cloud consola para criar ou gerir as suas vistas do Analytics.
  • Pode criar, no máximo, 100 visualizações de propriedade do Analytics por Google Cloud projeto.
  • Pode criar, no máximo, 50 visualizações de propriedade do Google Analytics por região.
  • Por Google Cloud projeto, no máximo, 10 regiões podem conter uma vista de estatísticas.

O que se segue?