Registro y supervisión de los complementos de Media CDN

En esta página, se muestra cómo configurar y usar Cloud Logging y Cloud Monitoring con los complementos de extensiones de servicio para Media CDN.

Logging

En esta sección, se describen los registros de las extensiones del servicio para los complementos de Media CDN y cómo puedes ver y correlacionar la información en los mensajes de registro.

Mensajes de registro

Las extensiones de servicio admiten la generación de mensajes de registro durante la ejecución de tu complemento. El registro de grabación está inhabilitado de forma predeterminada. Para registrar los registros de un complemento, habilítalo cuando crees el complemento o lo actualices.

Los registros de registro del complemento se anotan con la siguiente información contextual:

Anotaciones de registro estándar, como la marca de tiempo y el nivel de registro
Es la identidad del complemento que generó el mensaje.
Es la devolución de llamada del complemento en la que se generó el mensaje de registro.
Es un identificador de seguimiento de requestId que ayuda a determinar el registro de solicitudes con el que se asocia un mensaje de registro.

Los registros pertinentes para las extensiones de servicio se encuentran en una de las siguientes categorías:

Mensajes de registro del complemento

Se genera mediante una llamada de registro, como info!(...) para Rust, proxywasm.LogInfo(...) para Go o LOG_INFO para C++. Las extensiones de servicio exportan estos mensajes de registro a Cloud Logging. Puedes registrar los encabezados de solicitud y respuesta, y cualquier acción que haya realizado el complemento.

Puedes ver estos mensajes con el servicio networkservices.googleapis.com.
Mensajes de registro de Media CDN

Mensajes de registro de Media CDN para solicitudes HTTP a recursos EdgeCacheService con una acción de Wasm asociada. Son entradas de registro normales de Media CDN que se pueden ver en el servicio edgecache.googleapis.com.

Cómo habilitar el registro para un complemento

Las extensiones de servicio admiten la generación de mensajes de registro durante la ejecución de tu complemento. El registro de grabación está inhabilitado de forma predeterminada.

Para registrar los registros de un complemento, habilítalo cuando crees el complemento o lo actualices.

Para habilitar el registro de un complemento existente, usa el comando gcloud beta service-extensions wasm-plugins update:

gcloud beta service-extensions wasm-plugins update WASM_PLUGIN \
    --log-config=[LOG_CONFIG,...]

Reemplaza lo siguiente:

WASM_PLUGIN: Es el ID o el nombre completamente calificado del complemento.
LOG_CONFIG: Son las opciones de registro del complemento. Para habilitar el registro, configura la opción enable en true. Luego, especifica los siguientes detalles:
- sample-rate: Es la tasa de muestreo de los registros de actividad como un valor entre 0 y 1. El valor 0 indica que no se almacenan mensajes de registro. El valor predeterminado 1 indica que se almacenan todos los mensajes de registro. Un valor de punto flotante entre 0.0 y 1.0 indica que se almacena un porcentaje de los mensajes de registro.
- min-log-level: Es el nivel de gravedad mínimo de los mensajes de registro del complemento que se exportarán a Cloud Logging. El valor predeterminado es INFO.

Después de habilitar el registro para el complemento, puedes ver los mensajes que emiten las instrucciones de registro en el código del complemento en Cloud Logging.

Para ver los registros, en la consola de Google Cloud , ve a la página Explorador de registros.

Cómo ver mensajes de registro

Para ver los registros, compila consultas en el Explorador de registros.

Puedes ver los registros de complementos como registros independientes de las Extensiones del servicio. En esta vista, cada mensaje de registro del complemento se registra en su propio registro y no se asocia automáticamente con la información del registro de solicitudes.

Estos mensajes de registro se encuentran en el registro networkactions.googleapis.com/wasm_plugin_activity con el tipo de recurso networkactions.googleapis.com/WasmPluginVersion.

El sistema también puede agregar mensajes de registro informativos a este registro. Por ejemplo, si se produce un error en un complemento cuando una invocación de complemento supera los límites de CPU o memoria, se registra un mensaje con la gravedad ERROR. Estos mensajes también se pueden ver en Ver y filtrar errores.

También puedes ver los mensajes de registro correlacionados con los registros de solicitudes de Media CDN correspondientes en el Explorador de registros. Mientras ves los registros de solicitudes, cuando expandes una entrada de registro de solicitud, los registros del complemento relacionados con la solicitud aparecen anidados debajo del registro de solicitud. Esta vista te ayuda a comprender los registros de complementos en el contexto de su solicitud asociada.

Muestras de registros

Considera una entrada de registro de ejemplo de las extensiones del servicio. El valor de message se pasa a la llamada LOG_INFO del complemento. El valor de severity depende del nivel de registro que se usa en la llamada de registro del complemento. En la sección labels, el valor de la API es HTTP_REQUEST_HEADER, lo que indica que la operación registrada es la devolución de llamada del complemento on_http_request_headers.

{
  "insertId": "65224aac-0000-24bd-a0e1-582429bd544c@a1",
  "jsonPayload": {
    "@type": "type.googleapis.com/google.cloud.networkactions.logging.v1.WasmPluginLogEntry",
    "metroIataCode": "ber",
    "proxyRegionCode": "DE",
    "message": "[add_header_plugin.cc:26]::onRequestHeaders() AddHeaderStreamContext::onRequestHeaders called",
    "requestId": "effc0311-6716-431b-9e2a-7586835fdff1"
  },
  "resource": {
    "type": "networkactions.googleapis.com/WasmPluginVersion",
    "labels": {
      "plugin_version": "prod-1",
      "resource_container": "projects/123456789",
      "location": "global",
      "plugin_name": "add-headers-plugin-prod-resource"
    }
  },
  "timestamp": "2023-05-10T03:05:43.317015458Z",
  "severity": "INFO",
  "labels": {
    "networkactions.googleapis.com/operation": "HTTP_REQUEST_HEADERS"
  },
  "logName": "projects/123456789/logs/networkactions.googleapis.com%2Fwasm_plugin_activity",
  "trace": "projects/123456789/traces/effc0311-6716-431b-9e2a-7586835fdff1",
  "receiveTimestamp": "2023-05-10T03:05:44.207265284Z"
}

La entrada de registro relacionada de Media CDN aparece de la siguiente manera. Los valores de requestId y trace en ambos mensajes de registro son los mismos.

{
  "insertId": "6c95cc54-0000-26ba-ba73-f403043c328c@a1",
  "jsonPayload": {
    "cacheMode": "USE_ORIGIN_HEADERS",
    "@type": "type.googleapis.com/google.cloud.edgecache.v1.EdgeCacheLogEntry",
    "wasmAction": "add-headers-action-prod-resource",
    "cacheKeyFingerprint": "f04d02bb12f2e79e",
    "proxyStatus": "Google-Edge-Cache",
    "clientCity": "Erlangen",
    "clientAsn": "8881",
    "origin": "example-origin",
    "cacheId": "ber",
    "tlsVersion": "NONE",
    "latency": "0.002840304s",
    "originIp": "142.250.145.128",
    "requestId": "effc0311-6716-431b-9e2a-7586835fdff1",
    "clientRegionCode": "DE",
    "originalRequestId": "7656c418-df7c-4ae5-9db5-4f247ec5a82c",
    "httpTtfb": "0.002814903s",
    "metroIataCode": "BER",
    "proxyRegionCode": "DE",
    "cacheStatus": "hit"
  },
  "httpRequest": {
    "requestMethod": "GET",
    "requestUrl": "https://example.com/image.jpg",
    "requestSize": "1631",
    "status": "200",
    "responseSize": "402907",
    "userAgent": "Wtrace",
    "remoteIp": "2001:1438:1:19::5",
    "protocol": "HTTP/1.1"
  },
  "resource": {
    "type": "edgecache.googleapis.com/EdgeCacheRouteRule",
    "labels": {
      "location": "global",
      "route_destination": "projects/123456789/locations/global/edgeCacheOrigins/example-origin",
      "matched_path": "/turing/",
      "route_type": "ORIGIN",
      "path_matcher_name": "routes",
      "resource_container": "projects/123456789",
      "service_name": "example-service"
    }
  },
  "timestamp": "2023-05-10T03:05:43.321347304Z",
  "logName": "projects/bdn-prober/logs/edgecache.googleapis.com%2Fedge_cache_request",
  "trace": "projects/1069774196212/traces/effc0311-6716-431b-9e2a-7586835fdff1",
  "receiveTimestamp": "2023-05-10T03:05:49.919781008Z"
}

Limitaciones

Los complementos se limitan a registrar hasta 16 KiB de datos de carga útil por solicitud HTTP del cliente. Este importe se divide entre varias llamadas de registro asociadas a una solicitud HTTP determinada. El límite solo se aplica al texto del mensaje de registro, no a los metadatos adicionales que las extensiones del servicio agregan al registro.

Por ejemplo, si una devolución de llamada on_http_request_headers realiza dos llamadas de registro con mensajes de 4 KiB cada una y, luego, una devolución de llamada on_http_response_headers intenta realizar tres llamadas de registro con mensajes de 4 KiB cada una para la misma solicitud HTTP, se descarta el tercer mensaje de registro. Se agrega un mensaje de registro para registrar la cantidad de mensajes de registro generados por el complemento que se descartaron.

Supervisión

En esta sección, se describe cómo puedes usar los paneles de Cloud Monitoring para ver las métricas de las extensiones del servicio para los complementos de Media CDN.

Para obtener información detallada sobre los tipos de métricas de las extensiones de servicio, consulta la página Métricas deGoogle Cloud .

Visualiza el panel de Monitoring de las extensiones de servicio

Para ver el panel de Supervisión de las extensiones de servicio, haz lo siguiente:

En la consola de Google Cloud , ve a la página Extensiones de servicio.
Ir a Extensiones del servicio
Haz clic en la pestaña Complementos.
Haz clic en el nombre de un complemento.
En la página Detalles del complemento, haz clic en la pestaña Monitoring.

En la página Monitoring, los gráficos de métricas muestran información que puede ayudarte a supervisar el rendimiento del complemento.

Para ver las métricas de las operaciones del ciclo de vida del complemento, selecciona valores de la lista Filtro de operación. De forma predeterminada, se seleccionan los valores HTTP request header y HTTP response header.
Para ver las métricas de una versión específica del complemento, selecciona un valor de la lista Filtro de versión del complemento. De forma predeterminada, se muestran las métricas de todas las versiones.
Para cambiar el período para el que deseas ver los datos, selecciona un período predefinido en el selector de tiempo o haz clic en Personalizado y define una hora de inicio y de finalización. De forma predeterminada, el selector se establece en 1 day.

Métricas de complementos para las extensiones del servicio

Puedes supervisar las siguientes métricas de los complementos desde la perspectiva de las extensiones de servicio. Estas métricas tienen el prefijo networkactions.googleapis.com/wasm_plugin/. El prefijo se omitió en las entradas de la tabla.

Tipo de métrica	Nombre visible Clase, Tipo, Unidad Descripción
`invocation_count`	Recuento de invocaciones del complemento de Wasm `DELTA`, `INT64`, `1` Es la cantidad de invocaciones del complemento durante el período seleccionado. Cada invocación de devolución de llamada del complemento se cuenta como una invocación independiente del complemento.
`invocation_latencies`	Latencia de invocación del complemento de Wasm `DELTA`, `DISTRIBUTION`, `us` Es el tiempo de ejecución local del complemento, en milisegundos. La métrica incluye entradas delimitadas por etiquetas para cada devolución de llamada.
`cpu/usage_times`	Uso de CPU normalizado del complemento de Wasm `DELTA`, `DISTRIBUTION`, `us{CPU}` Es el tiempo de uso de CPU de las invocaciones del complemento, en microsegundos.
`memory/bytes_used`	Uso de memoria del complemento de Wasm `GAUGE`, `DISTRIBUTION`, `By` Memoria total asignada por las VMs del complemento de Wasm, en bytes.

Métricas del complemento para Media CDN

Puedes supervisar las siguientes métricas para los complementos desde la perspectiva de Media CDN. Las cadenas de tipo de métrica siguen este prefijo: edgecache.googleapis.com/edge_cache_route_rule/network_actions/. El prefijo se omitió en las entradas de la tabla.

Tipo de métrica	Nombre visible Clase, Tipo, Unidad Descripción
`wasm_action_invocation_count`	Cantidad de invocaciones de Service Extensions `DELTA`, `INT64`, `1` Es la cantidad de invocaciones de Service Extensions que Media CDN controló durante el período seleccionado.
`wasm_action_invocation_latencies`	Latencia de invocación de extensiones del servicio `DELTA`, `DISTRIBUTION`, `us` Es el tiempo total, en milisegundos, que tarda Media CDN en despachar y ejecutar el complemento. La métrica incluye entradas delimitadas por etiquetas para las extensiones de servicio de devolución de llamada.