Registro y supervisión de las llamadas externas del Secure Web Proxy

En esta página, se muestra cómo configurar y usar Cloud Logging y Cloud Monitoring con textos destacados de extensiones de servicio para Secure Web Proxy.

Logging

Secure Web Proxy usa Logging para capturar y almacenar varios tipos de registros, incluidos los relacionados con las extensiones. Para obtener información sobre el registro de Secure Web Proxy, consulta Registros.

En general, las entradas de registro del balanceador de cargas de aplicaciones contienen información útil para supervisar y depurar el tráfico HTTP o HTTPS. Las entradas de registro contienen los siguientes tipos de información:

  • Información que se muestra en la mayoría de los registros de Google Cloud , como la gravedad, el ID del proyecto, el número del proyecto y la marca de tiempo, como se describe en el registro LogEntry.
  • Campos de registro de HttpRequest.

Los registros de solicitudes de los balanceadores de cargas HTTP y HTTPS contienen un objeto service_extension_info en la carga útil de JSON de la entrada de registro del balanceador de cargas con la siguiente información:

Campo Tipo Descripción
backend_target_name cadena Es el nombre del destino de backend de la extensión.
backend_target_type cadena Es el tipo de destino de backend.
chain cadena Es el nombre de la cadena de extensiones dentro del recurso de extensión de servicio que coincide con la solicitud.
extension cadena Es el nombre de la extensión dentro de la cadena de extensiones.
failed_open booleano Cuando la configuración de la extensión tiene failOpen establecido en true, el valor true para esta métrica indica que el procesamiento continuó cuando la extensión se agotó o falló.

Solo se aplica a los balanceadores de cargas de aplicaciones externos regionales, los balanceadores de cargas de aplicaciones internos regionales y los balanceadores de cargas de aplicaciones internos entre regiones.

grpc_status enum Es el estado más reciente de la transmisión de gRPC. Para obtener más información, consulta Códigos de estado de gRPC.
per_processing_request_info array Es una lista de estadísticas de ProcessingRequest para las extensiones de ext_proc o estadísticas de CheckRequest para las extensiones de ext_authz que se producen en la transmisión de gRPC.
per_processing_request_info[].event_type enum Es el tipo de evento de ProcessingRequest. Puede ser una de las siguientes opciones: REQUEST_HEADERS, REQUEST_BODY, RESPONSE_HEADERS o RESPONSE_BODY.
per_processing_request_info[].latency duración Es la duración desde que se envía el primer byte del mensaje ProcessingRequest a la extensión hasta que se recibe el último byte del mensaje ProcessingResponse.
per_processing_request_info[].processing_effect enum Es el resultado del procesamiento de cada evento en una solicitud de procesamiento.

Solo se aplica a los balanceadores de cargas de aplicaciones externos regionales, los balanceadores de cargas de aplicaciones internos regionales y los balanceadores de cargas de aplicaciones internos entre regiones.

Puede ser uno de los siguientes valores:

  • NONE: Indica que no se modificó el contenido.
  • NONE_FAILED_OPEN: Indica que no se realizaron mutaciones porque la extensión falló en modo abierto.
  • CONTENT_MODIFIED: Indica que el contenido se modificó con una solicitud de mutación aplicada correctamente.
  • IMMEDIATE_RESPONSE: Indica que la extensión envió una respuesta inmediata para detener todo el procesamiento posterior.
  • MUTATION_REJECTED: Indica que la extensión solicitó al menos un cambio no permitido y se descontinuó el procesamiento posterior. Se registran los mensajes de error adecuados.
  • UNSPECIFIED: Indica que se desconoce el efecto del procesamiento.
per_processing_request_info[].processing_effect_details cadena Cuando processing_effect es MUTATION_REJECTED, los detalles sobre por qué se rechazó una mutación.

Solo se aplica a los balanceadores de cargas de aplicaciones externos regionales, los balanceadores de cargas de aplicaciones internos regionales y los balanceadores de cargas de aplicaciones internos entre regiones.

resource cadena Nombre del recurso de extensión

Supervisión

Para obtener información sobre las métricas de Monitoring para Secure Web Proxy, consulta Métricas disponibles.

En la versión preliminar, puedes supervisar las siguientes métricas para las extensiones en todos los tipos de balanceadores de cargas de aplicaciones. Estas métricas tienen el prefijo networkservices.googleapis.com. El prefijo se omite en las entradas de la siguiente tabla.

En la siguiente tabla, se proporcionan el tipo de métrica, el nombre visible, la clase, el tipo, la unidad y la descripción de cada métrica.

Tipo de métrica Nombre visible
Clase, tipo, unidad
Descripción
extension/invocation_count Recuento de invocaciones de extensiones
DELTA, INT64, 1
Es la cantidad de invocaciones enviadas a la extensión.
extension/invocation_latencies Latencias de invocación de extensiones
DELTA, DISTRIBUTION, ms
La distribución calculada a partir de la latencia de cada invocación de extensión. Solo se aplica a las extensiones de texto destacado y no se admite para los complementos.
extension/sent_chunks_count Recuento de fragmentos enviados por la extensión
DELTA, INT64, 1
Solo se aplica a los eventos request_body y response_body. Es la cantidad de fragmentos de datos que se enviaron a la extensión.
extension/received_chunks_count Recuento de fragmentos recibidos por la extensión
DELTA, INT64, 1
Solo se aplica a los eventos request_body y response_body. Es la cantidad de fragmentos recibidos de la extensión.
extension/failed_open_count Invocaciones fallidas de la extensión con fail-open
DELTA, INT64, 1
La cantidad de veces que falló una invocación cuando el sistema se configuró para fail-open y se permitió que la solicitud continuara.
extension/mutation_rejections_count Recuento de rechazos de mutaciones de extensiones
DELTA, INT64, 1
La cantidad de invocaciones que solicitaron mutaciones de encabezado, cuerpo o final, pero se rechazaron. Los rechazos pueden ocurrir por varios motivos, como cuando la mutación no es válida o supera los límites de tamaño.
extension/sent_bytes_count Recuento de bytes enviados de la extensión
DELTA, INT64, By
Es la cantidad de bytes enviados a la extensión.
extension/received_bytes_count Recuento de bytes recibidos de la extensión
DELTA, INT64, By
Es la cantidad de bytes recibidos de la extensión.