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?
- Si quieres entender mejor cómo configurar métricas basadas en registros para definir tu propios valores de métricas basados en solicitudes registradas, consulta el artículo Métricas basadas en registros descripción general.
- Para obtener más información sobre los precios de Logging, consulta Precios de Google Cloud Observability.
- Para obtener información sobre cómo funciona el registro de auditoría y cómo habilitar y configurar los registros de auditoría para la actividad del administrador, consulta la Documentación de los registros de auditoría de Cloud.