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, se filtran y se almacenan 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
...

Establece la tasa de muestreo de registros

En volúmenes grandes de solicitudes, en lugar de capturar un registro para cada solicitud, es posible que prefieras realizar muestras de los registros y depender de las métricas para la supervisión y la investigación proactivas.

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.

La tasa de muestreo, a menos que se especifique lo contrario, se establece de forma predeterminada en 0 (0%), lo que registra cada solicitud del 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.

En la siguiente consulta de registro, se muestran los registros de todos tus servicios de Media CDN:

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

Para filtrar registros asociados con un recurso y un proyecto EdgeCacheService específicos, 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, consulta las comparaciones de lenguaje de consulta de registro.

Ejemplo: Identifica errores de caché

Una solicitud de un objeto puede ser un error de caché, pero puede provocar un relleno de caché por los siguientes motivos:

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

Para identificar las faltas de caché, puedes filtrar los registros en el 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 el campo httpRequest.requestUrl:

httpRequest.requestUrl = "URL"

Para filtrar parte de la URL, como el componente de ruta de acceso, usa el operador has:

# `:` 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 integral de Logging para la coincidencia y el filtrado, consulta Cómo escribir consultas avanzadas con el lenguaje de consultas de Logging.

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, lo que 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?