Configure o registo de pedidos

Esta página mostra como configurar o registo de pedidos para a RFC de multimédia.

Ative os registos

O registo está desativado por predefinição para minimizar os dados armazenados. Os registos são encaminhados, filtrados e armazenados no Cloud Logging.

  • Ative o registo para um serviço de CDN de multimédia específico:

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

  • Desative o registo:

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

  • Obtenha o estado atual do registo num serviço:

    gcloud edge-cache services describe YOUR_SERVICE

    O resultado é semelhante ao seguinte:

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

Defina a taxa de amostragem de registos

Para grandes volumes de pedidos, em vez de capturar um registo para cada pedido, pode preferir fazer uma amostragem dos registos e basear-se nas métricas para monitorização e investigação proativas.

Para carregar e armazenar apenas registos de 10% dos seus pedidos, defina logConfig.sampleRate como 0.1:

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

O registo tem de estar ativado para alterar a taxa de amostragem.

A taxa de amostragem, salvo especificação em contrário, é predefinida como 0 (0%), o que regista todos os pedidos para o serviço configurado.

Registos de consultas

Para consultar registos, pode usar o Explorador de registos na Google Cloud consola ou pode usar a CLI Google Cloud.

Para ver os registos na Google Cloud consola, filtre por tipo de recurso do Media CDN e (opcionalmente) por projeto e nome do serviço.

A consulta de registo seguinte mostra os registos de todos os seus serviços de RFC de multimédia:

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

Para filtrar registos associados a um recurso e um projeto específicos, expanda esta consulta:EdgeCacheService

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

Para fazer a correspondência com nomes parciais ou usar expressões regulares, consulte o artigo Comparações de linguagem de consulta de registo.

Exemplo: identifique falhas de cache

Um pedido de um objeto pode ser uma falha de cache, mas pode causar um preenchimento da cache pelos seguintes motivos:

  • Um tempo de vida (TTL) demasiado curto
  • Uma chave de cache demasiado específica
  • Demasiados poucos pedidos para permanecerem em cache

Para identificar falhas de cache, pode filtrar os registos no Explorador de registos.

A consulta de registo seguinte mostra pedidos que são armazenáveis em cache (procurados), mas que requerem 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 de filtrar por um URL específico, filtre pelo campo httpRequest.requestUrl:

httpRequest.requestUrl = "URL"

Para filtrar por parte do URL, como o componente do 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 o artigo Escreva consultas avançadas com a linguagem de consulta do Logging.

Filtre registos armazenados

Para filtrar os registos antes de os armazenar (por exemplo, capturar apenas campos pertinentes para reduzir o volume total de registos que tem de armazenar e consultar), pode configurar filtros de exclusão, que lhe permitem definir uma consulta (filtro) que inclui ou exclui campos antes do armazenamento.

Também pode configurar vários filtros, por exemplo, capturar todos os pedidos de cache miss ou todos os pedidos de um nome de anfitrião específico e apenas obter uma amostra de todos os registos.

Registos de rotas

A RFC de multimédia integra-se diretamente com o Cloud Logging, o que ajuda a agregar e encaminhar os seus registos das seguintes formas:

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

  • A tópicos do Pub/Sub, aos quais os destinos de terceiros se podem subscrever para aceder aos registos

Para uma vista geral de como os registos são encaminhados a partir do Logging, consulte a Vista geral do encaminhamento e do armazenamento.

O que se segue?