Registro y supervisión del plano de control

En este documento, se muestra cómo usar Cloud Logging y Cloud Monitoring para ver los registros y las métricas del plano de control de Cloud Service Mesh.

El uso de una malla de servicios te permite observar el tráfico hacia los servicios, y desde ellos, lo que permite una mejor supervisión y depuración sin cambios de código en el servicio. Las entradas de registro pueden proporcionar información importante para solucionar problemas de la malla de servicios, incluidos los registros de conexiones y desconexiones exitosas, los informes de errores para clientes mal configurados y las alertas sobre conflictos de recursos de la API.

Casos de uso

Los siguientes son tres casos de uso para el registro y la supervisión del plano de control:

  • Cloud Logging para el plano de control de Cloud Service Mesh: Puedes almacenar, buscar, analizar y configurar alertas de forma segura en todos los datos y eventos de registro de Cloud Service Mesh mediante todas las funciones integradas de Logging. Cloud Service Mesh exporta registros a Logging cuando un cliente Envoy o gRPC se conecta o se desconecta, además de cuando detecta problemas de configuración.
  • Cloud Monitoring para el plano de control de Cloud Service Mesh: Cloud Service Mesh exporta una métrica clave que indica la cantidad de clientes conectados al plano de control de Cloud Service Mesh a Monitoring. Puedes configurar un panel en Monitoring y visualizar esta métrica en tiempo real para supervisar el estado de la malla a medida que los clientes se conectan y se desconectan. Esto también te permite configurar un SLO para tu malla.
  • Soluciona problemas de inmediato: Cloud Service Mesh exporta la telemetría a Logging y Monitoring de forma predeterminada. No se necesita ninguna configuración adicional para configurar el registro y la supervisión, lo que te permite solucionar problemas en cualquier momento, incluso cuando configuras la malla por primera vez.

Visualiza registros

Para ver los registros de Cloud Service Mesh, usa el Explorador de registros. En la siguiente sección, se presenta una consulta de ejemplo para ver los registros de Cloud Service Mesh, pero puedes usar el vínculo anterior para crear tu propia consulta.

  1. En la consola de Google Cloud, ve a la página Explorador de registros.

    Ir al Explorador de registros.

  2. En la lista Recurso, haz lo siguiente:
    • Si usas las APIs de enrutamiento de servicios, selecciona Gateway Scope o Mesh.
    • Si usas las APIs anteriores, selecciona GCE Network.
  3. En la lista Nombre del registro, selecciona trafficdirector.googleapis.com/events.
  4. Haz clic en Ejecutar consulta.

Campos de entrada de registro de Cloud Service Mesh

Campo Descripción
node_id ID del nodo xDS-client, proporcionado por el xDS-client.
client_type Tipo de cliente xDS conectado a Cloud Service Mesh. Valores posibles:
  • ENVOY
  • GRPC-JAVA
  • GRPC-C++
  • GRPC-PYTHON
  • GRPC-GO
  • UNKNOWN
node_ip Dirección IP del nodo proporcionado por el cliente.
api_version La versión de la API de xDS que usan los clientes de xDS para conectarse a Cloud Service Mesh. Los valores posibles son V2 y V3.
description Descripción textual del evento con detalles adicionales.

Ejemplos de entradas de registro

Ejemplo de la entrada de registro Descripción
“Cloud Service Mesh no pudo encontrar ninguna configuración para el cliente xDS”. Este registro se genera cuando Cloud Service Mesh rechaza el cliente xDS porque no existe ninguna configuración. Esto puede deberse a la configuración incompleta de los recursos de API relevantes de Cloud Service Mesh.
“El cliente se conectó correctamente”. Este tipo de mensaje de registro se genera cada vez que un cliente se conecta de forma correcta a Cloud Service Mesh.
“El cliente se desconectó correctamente”. Este tipo de mensaje de registro se genera cada vez que se desconecta un cliente establecido de Cloud Service Mesh.
“TRAFFICDIRECTOR_INTERCEPTION_PORT” no está configurada. La configuración de enrutamiento para el objeto de escucha de la interceptación existe, pero se ignorará. Este tipo de mensaje de registro se genera cuando los recursos de Cloud Service Mesh se configuran correctamente, pero la variable TRAFFICDIRECTOR_INTERCEPTION_PORT no está configurada en los metadatos del nodo del cliente xDS, por lo que no se puede agregar esta configuración al cliente.
“El objeto de escucha de la interceptación se basa en el puerto 15001 determinado, pero no existe la configuración de enrutamiento”. Este tipo de mensaje de registro se genera cuando la variable TRAFFICDIRECTOR_INTERCEPTION_PORT se configura en los metadatos del nodo cliente xDS, pero no se configuraron recursos para que Cloud Service Mesh genere una respuesta xDS completa.
“No se pudo enviar la respuesta de ADS desde Cloud Service Mesh. La última solicitud de descubrimiento del nodo tenía una versión o un nonce incorrectos”. Este tipo de mensaje de registro se genera cuando Cloud Service Mesh no puede procesar la respuesta xDS de forma correcta debido a la comunicación dañada del cliente xDS. Este mensaje indica un error de implementación en el cliente. Recomendamos que verifiques los registros del cliente.
“El cliente envía tráfico entre regiones al servicio de backend backend_service_id. Región de origen: source_region Regiones de destino: destination_region1, destination_region2" Este tipo de mensaje de registro se genera cuando un cliente informa a la malla de servicios de Cloud que envió tráfico entre regiones de una región de origen a una o más regiones de destino.

Ver métricas

Cloud Service Mesh exporta tres métricas a Cloud Monitoring: xDS API Connected Streams, Request count y Request count by zone. xDS API Connected Streams indica la cantidad de clientes que están conectados a tu plano de control. Request count indica la cantidad de solicitudes que se envían a un servicio de backend, agrupadas por región de origen, región de destino y estado de la solicitud. En Recuento de solicitudes por zona, se indica la cantidad de solicitudes que se envían a un servicio de backend, agrupadas por zona de origen, zona de destino y estado de la solicitud. Para ver estas métricas, usa el Explorador de métricas.

Para ver las métricas de Cloud Service Mesh, haz lo siguiente:

  1. En la consola de Google Cloud, ve a la página Explorador de métricas.

    Ir al Explorador de métricas

  2. En la lista Tipo de recurso, selecciona un recurso.
    • Si usas las APIs de enrutamiento de servicios, selecciona Gateway Scope o Mesh.
    • Si usas las APIs anteriores, selecciona Network.
  3. En la lista Métrica, selecciona connected_clients.
  4. Regresa a la lista Tipo de recurso y, luego, selecciona Compute Engine Backend Service.
  5. En la lista Métrica, selecciona Request count o Request count by zone.

Como alternativa, puedes usar una consulta para ver el recuento de solicitudes entre regiones:

  1. Selecciona MQL.
  2. En el campo, ingresa la siguiente consulta de ejemplo: 
    fetch gce_backend_service
| metric 'trafficdirector.googleapis.com/xds/server/request_count'
| filter ( ne(metric.source_region, metric.destination_region))
| align rate(1m)
| every 1m
| group_by [metric.source_region, metric.destination_region, resource.backend_service_id],
[value_request_count_aggregate: aggregate(value.request_count)]
  3. Haga clic en Run query.

Configura alertas y métricas basadas en registros

En los siguientes pasos, se requiere que configures métricas basadas en registros. Para obtener más información sobre la configuración de métricas basadas en registros, consulta la descripción general.

Puedes configurar alertas para que te notifiquen cuando los mensajes especificados por el usuario aparezcan en los registros incluidos. Estas alertas pueden notificar al operador cuando se produce algo inesperado. Por ejemplo, si un cambio en la configuración de Cloud Service Mesh genera conflictos de recursos de API, puedes recibir una alerta sobre el mensaje de error. A fin de configurar alertas en tus métricas basadas en registros, consulta Configura gráficos y alertas.