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

Para ingerir e armazenar apenas registros de 10% das suas solicitações, defina De logConfig.sampleRate a 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 para 0 (0%), que registra todas as solicitações para o serviço configurado.

Registros da consulta

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

Para acessar registros no console do Google Cloud, filtre por Media CDN tipo de recurso e, opcionalmente, 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 registros associados a um recurso EdgeCacheService específico e , 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 a Consulta do Logging e comparações de idiomas.

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 para pelos seguintes motivos:

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

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

A consulta de registro a seguir mostra solicitações que podem ser armazenadas em cache (pesquisadas), mas que 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, use o filtro Campo httpRequest.requestUrl:

httpRequest.requestUrl = "URL"

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

# `:` 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 os registros antes de armazená-los, por exemplo, capturar somente campos pertinentes para reduzir o volume total de registros que precisa armazenar e consultar, é possível 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, capturando todas as ausências no cache ou todas as solicitações de um nome de host específico e usando apenas uma amostra todos os registros.

Encaminhar registros

O Media CDN se integra diretamente ao Cloud Logging, ajuda a agregar e encaminhar os registros das seguintes maneiras:

  • Para destinos de armazenamento, como Cloud Storage e BigQuery

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

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

A seguir