Configurar el registro de solicitudes

En esta página se explica cómo configurar el registro de solicitudes en Media CDN.

Habilitar registros

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

  • Para habilitar el registro de un servicio de Media CDN específico, sigue estos pasos:

    gcloud edge-cache services update YOUR_SERVICE \
       --enable-logging \
       --logging-sample-rate=1.0
    
  • Inhabilitar el registro:

    gcloud edge-cache services update YOUR_SERVICE \
       --no-enable-logging
    
  • Para obtener el estado actual del registro de un servicio, haz lo siguiente:

    gcloud edge-cache services describe YOUR_SERVICE
    

    El resultado debería ser similar al siguiente:

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

Definir la frecuencia de muestreo de los registros

Si el volumen de solicitudes es grande, en lugar de registrar cada solicitud, puede que prefieras muestrear los registros y usar las métricas para monitorizar e investigar de forma proactiva.

Para ingerir y almacenar registros solo del 10% de tus solicitudes, asigna el valor 0.1 a logConfig.sampleRate:

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

El registro debe estar habilitado para cambiar la frecuencia de muestreo.

La frecuencia de muestreo, a menos que se especifique lo contrario, es 0 (0%) de forma predeterminada, lo que significa que se registra cada solicitud del servicio configurado.

Registros de consultas

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

Para ver los registros en la consola, filtre por el tipo de recurso Media CDN y, opcionalmente, por proyecto y nombre de servicio. Google Cloud

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

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

Para filtrar los registros asociados a un EdgeCacheService recurso y un proyecto específicos, amplía esta consulta:

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

Para obtener coincidencias con nombres parciales o usar expresiones regulares, consulta las comparaciones del lenguaje de consulta de registros.

Ejemplo: identificar fallos de caché

Puede que una solicitud de un objeto no se encuentre en la caché, pero que provoque que se rellene por los siguientes motivos:

  • Un tiempo de vida (TTL) demasiado corto
  • Una clave de caché demasiado específica
  • Demasiadas pocas solicitudes para permanecer en la caché

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

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

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

Si necesita filtrar por una URL específica, filtre por el campo httpRequest.requestUrl:

httpRequest.requestUrl = "URL"

Para filtrar por una parte de la URL, como el componente de ruta, usa el hasoperador:

# `:` 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 obtener más información sobre la sintaxis completa de Logging para buscar y filtrar, consulta el artículo Escribir consultas avanzadas con el lenguaje de consultas de Logging.

Filtrar registros almacenados

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

También puedes configurar varios filtros, por ejemplo, para registrar todas las solicitudes de fallo de caché o todas las solicitudes de un nombre de host específico, y solo tomar una muestra de todos los registros.

Registros de rutas

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

  • A destinos de almacenamiento, como Cloud Storage y BigQuery

  • A los temas de Pub/Sub, a los que pueden suscribirse destinos de terceros para acceder a los registros

Para ver una descripción general de cómo se enrutan los registros desde Logging, consulta la información general sobre el enrutamiento y el almacenamiento.

Siguientes pasos