Configura el registro de solicitudes

En esta página, se muestra cómo configurar el registro de solicitudes para Media CDN.

Habilitar registros

El registro está inhabilitado de forma predeterminada para minimizar los datos almacenados. Los registros se enrutan filtrar y almacenar en Cloud Logging.

  • Habilita el registro para un servicio de Media CDN específico:

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

  • Inhabilita el registro:

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

  • Obtén el estado actual de registro en un servicio:

    gcloud edge-cache services describe YOUR_SERVICE

    El resultado es similar a este:

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

Cómo establecer la tasa de muestreo del registro

Para grandes volúmenes de solicitudes, en lugar de capturar un registro por cada solicitud, puede preferir muestrear registros y basarse en métricas para realizar una supervisión proactiva e investigación.

Para transferir y almacenar solo los registros del 10% de tus solicitudes, establece De logConfig.sampleRate a 0.1:

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

Se debe habilitar el registro para cambiar la tasa de muestreo.

A menos que se especifique lo contrario, la tasa de muestreo se establece de forma predeterminada en 0 (0%), lo que registra cada solicitud para el servicio configurado.

Registros de consultas

Para consultar registros, puedes usar Explorador de registros en la la consola de Google Cloud o puedes usar Google Cloud CLI.

Para ver los registros en la consola de Google Cloud, filtra por tipo de recurso de Media CDN y (de forma opcional) por nombre de proyecto y servicio.

La siguiente consulta de registro muestra los registros de todos tus servicios de Media CDN:

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

Filtrar por registros asociados con un recurso EdgeCacheService específico proyecto, extiende esta consulta:

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

Para hacer coincidir nombres parciales o usar expresiones regulares, lee la Consulta de Logging comparaciones de idiomas.

Ejemplo: Identifica errores de caché

Una solicitud de un objeto puede ser un error de caché, pero podría provocar un llenado de caché para por los siguientes motivos:

  • Un tiempo de actividad (TTL) que es demasiado corto
  • Una clave de caché demasiado específica
  • Muy pocas solicitudes para permanecer almacenadas en caché

Para identificar errores de caché, puedes filtrar los registros en Explorador de registros.

La siguiente consulta de registro muestra las solicitudes que se pueden almacenar en caché (buscadas), pero que requieren un relleno desde el origen:

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

Si necesitas filtrar por una URL específica, filtra en la Campo httpRequest.requestUrl:

httpRequest.requestUrl = "URL"

Para filtrar parte de la URL, como el componente de la ruta de acceso, utiliza el parámetro 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")

Si quieres obtener más información sobre la sintaxis completa de Logging para buscar coincidencias, y filtros, consulta Escribe consultas avanzadas con la consulta de Logging idioma.

Filtra los registros almacenados

Filtrar registros antes de almacenarlos (por ejemplo, solo capturar campos pertinentes) para reducir el volumen total de registros que debes almacenar y consultar. configurar los filtros de exclusión que te permiten definir una consulta (filtro) que incluye o excluye campos antes de almacenarla.

También puedes configurar varios filtros, por ejemplo, si se capturan todas las solicitudes de error de caché o todas las solicitudes de un nombre de host específico, y solo se toma una muestra de todos los registros.

Registros de ruta

Media CDN se integra directamente en Cloud Logging, que te ayuda a agregar y enrutar tus registros de las siguientes maneras:

  • A destinos de almacenamiento, como Cloud Storage y BigQuery

  • A temas de Pub/Sub, a qué destinos de terceros suscríbete para acceder a los registros

Para obtener una descripción general de cómo se enrutan los registros desde Logging, consulta Descripción general del enrutamiento y el almacenamiento.

¿Qué sigue?