Configurar a geração de registros de solicitações

Nesta página, mostramos como configurar a geração de registros de solicitações para o Media CDN.

Ativar registros

A geração de registros está desativada por padrão para minimizar os dados armazenados. Os registros são roteados, filtrados e armazenados no Cloud Logging.

  • Ative a geração de registros para um serviço específico do Media CDN:

    gcloud edge-cache services update YOUR_SERVICE \
   --enable-logging \
   --logging-sample-rate=1.0

  • Desative a geração de registros:

    gcloud edge-cache services update YOUR_SERVICE \
   --no-enable-logging

  • Para saber o estado atual da geração de registros em um serviço:

    gcloud edge-cache services describe YOUR_SERVICE

    O resultado será assim:

    ...
logConfig:
 enable: true
 sampleRate: 1.0
...

Definir a taxa de amostragem de registros

Para grandes volumes de solicitações, em vez de capturar um registro para cada solicitação, talvez você prefira fazer uma amostragem dos registros e contar com as métricas para monitoramento e investigação proativos.

Para ingerir e armazenar apenas registros de 10% das solicitações, defina logConfig.sampleRate como 0.1:

gcloud edge-cache services update YOUR_SERVICE \
    --enable-logging \
    --logging-sample-rate=0.1

A geração de registros precisa estar ativada para alterar a taxa de amostragem.

A taxa de amostragem, a menos que especificado de outra forma, é padronizada como 0 (0%), que registra todas as solicitações para o serviço configurado.

Registros da consulta

Para consultar registros, use a Análise de registros no console do Google Cloud ou a Google Cloud CLI.

Para visualizar registros no console do Google Cloud, filtre pelo tipo de recurso do Media CDN e, se quiser, por projeto e nome de serviço.

A consulta de geração de registros a seguir mostra os registros de todos os serviços do Media CDN:

resource.type="edgecache.googleapis.com/EdgeCacheRouteRule"

Para filtrar os registros associados a um recurso e projeto EdgeCacheService específicos, estenda esta consulta:

resource.type="edgecache.googleapis.com/EdgeCacheRouteRule"
resource.labels.resource_container="projects/12345678"
resource.labels.service_name="MY_PROJECT"

Para fazer a correspondência de nomes parciais ou usar expressões regulares, consulte as Comparações de linguagem de consulta do Logging.

Exemplo: identificar ausências no cache

A solicitação de um objeto pode ser uma ausência de cache, mas pode causar um preenchimento de cache pelos seguintes motivos:

  • Um time to live (TTL) muito curto
  • Uma chave de cache excessivamente específica
  • Há poucas solicitações para serem armazenadas em cache

Para identificar ausências no cache, filtre os registros na Análise de registros.

A consulta de registro a seguir mostra solicitações que podem ser armazenadas em cache (pesquisadas), mas exigem um preenchimento da origem:

resource.type="edgecache.googleapis.com/EdgeCacheRouteRule"
resource.labels.resource_container="projects/12345678"
resource.labels.service_name="MY_PROJECT"
jsonPayload.cacheStatus="miss"

Se precisar filtrar por um URL específico, filtre no campo httpRequest.requestUrl:

httpRequest.requestUrl = "URL"

Para filtrar parte do URL, como o componente de caminho, use o operador has:

# `:` is the `has` comparison operator

httpRequest.requestUrl: "/videos/1381381_1080.mp4"
# You can use `OR` or `AND` to filter on multiple values

httpRequest.requestUrl: ("https://media-test.example.com/" OR "https://canary.example.net")

Para saber mais sobre a sintaxe abrangente do Logging para correspondência e filtragem, consulte Criar consultas avançadas usando a linguagem de consulta do Logging.

Filtrar registros armazenados

Para filtrar os registros antes de armazená-los, por exemplo, capturando apenas campos pertinentes para reduzir o volume total de registros que você precisa armazenar e consultar, configure filtros de exclusão, que permitem definir uma consulta (filtro) que inclui ou exclui campos antes do armazenamento.

Também é possível configurar vários filtros. Por exemplo, capturar todas as solicitações de ausência no cache ou todas as solicitações de um nome de host específico e coletar apenas uma amostra de todos os registros.

Encaminhar registros

O Media CDN se integra diretamente ao Cloud Logging, o que ajuda você a agregar e rotear seus registros das seguintes maneiras:

  • Para destinos de armazenamento, como Cloud Storage e BigQuery

  • Nos tópicos do Pub/Sub, em que destinos de terceiros podem se inscrever para acessar os registros

Para ter uma visão geral de como os registros são roteados do Logging, consulte Visão geral de roteamento e armazenamento.

A seguir