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

Esta página mostra como configurar o registro 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 CDN de mídia:

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

  • Desativar a geração de registros:

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

  • Confira 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, você pode preferir usar amostras de registros e confiar em métricas para monitoramento e investigação proativos.

Para processar e armazenar apenas os 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 mudar a taxa de amostragem.

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

Registros da consulta

Para consultar registros, use o Logs Explorer no console do Google Cloud ou a Google Cloud CLI.

Para conferir os registros no console do Google Cloud, filtre pelo tipo de recurso da CDN de mídia e, opcionalmente, pelo nome do projeto e do serviço.

A consulta de registro a seguir mostra os registros de todos os seus serviços de CDN de mídia:

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

Para filtrar registros associados a um recurso e um 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 correspondências em nomes parciais ou usar expressões regulares, consulte as comparações de linguagem de consulta do Logging.

Exemplo: identificar falhas de cache

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

  • Um time to live (TTL) muito curto
  • Uma chave de cache muito específica
  • Poucas solicitações para manter o cache

Para identificar falhas de cache, filtre os registros no Explorador de registros.

A consulta de registro a seguir mostra solicitações que podem ser armazenadas em cache (procuradas), mas que 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 você 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 Gravar consultas avançadas usando a linguagem de consulta do Logging.

Filtrar registros armazenados

Para filtrar 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.

Você também pode configurar vários filtros, por exemplo, capturando todas as solicitações de falha de cache ou todas as solicitações de um nome de host específico e coletando apenas uma amostra de todos os registros.

Encaminhar registros

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

  • Para destinos de armazenamento, como o Cloud Storage e o BigQuery

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

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

A seguir