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
    
  • Para obtener el estado actual del registro en un servicio, ejecuta este comando:

    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 logConfig.sampleRate en 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 el Explorador de registros en la consola de Google Cloud o 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.

En la siguiente consulta de registro, se muestran las solicitudes que se pueden almacenar en caché (buscadas), pero que requieren un llenado 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

Para filtrar los registros antes de almacenarlos (por ejemplo, solo capturar los campos relevantes para reducir el volumen total de registros que necesitas almacenar y consultar), puedes configurar filtros de exclusión, que te permiten definir una consulta (filtro) que incluya o excluya campos antes del almacenamiento.

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 los que los destinos de terceros pueden suscribirse 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?