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 Traffic Director.

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 Traffic Director: Puedes almacenar, buscar, analizar y configurar alertas de forma segura en todos los datos y eventos de registro de Traffic Director mediante todas las funciones integradas de Logging. Traffic Director 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 Traffic Director: Traffic Director exporta una métrica clave que indica la cantidad de clientes conectados al plano de control de Traffic Director 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: Traffic Director 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 los registros

Para ver los registros de Traffic Director, usa el Explorador de registros. En la siguiente sección, se presenta una consulta de ejemplo para ver los registros de Traffic Director, pero puedes usar el vínculo anterior a fin de 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 (Resource), haz lo siguiente:
    • Si usas las APIs de enrutamiento de servicios, selecciona Gateway Scope o Mesh.
    • Si usas las APIs más antiguas, selecciona GCE Network.
  3. En la lista Nombre del registro, selecciona trafficdirector.googleapis.com/events.
  4. Haga clic en Run query.

Campos de entradas de registro de Traffic Director

Campo Descripción
node_id ID del nodo xDS-client, proporcionado por el xDS-client.
client_type Tipo de cliente xDS conectado a Traffic Director. 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 Traffic Director. 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
“Traffic Director no pudo encontrar ninguna configuración para el cliente xDS”. Este registro se genera cuando Traffic Director 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 Traffic Director.
“El cliente se conectó correctamente”. Este tipo de mensaje de registro se genera cada vez que un cliente se conecta de forma correcta a Traffic Director.
“El cliente se desconectó correctamente”. Este tipo de mensaje de registro se genera cada vez que se desconecta un cliente establecido de Traffic Director.
“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 Traffic Director 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 Traffic Director genere una respuesta xDS completa.
“No se pudo enviar la respuesta de ADS desde Traffic Director. 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 Traffic Director 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 Traffic Director que envió tráfico entre regiones de una región de origen a una o más regiones de destino.

Ver métricas

Traffic Director exporta tres métricas a Cloud Monitoring: Flujos conectados de la API de xDS, Recuento de solicitudes y Recuento de solicitudes por zona. Transmisiones conectadas de la API de xDS indica la cantidad de clientes que están conectados al plano de control. Recuento de solicitudes 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 Traffic Director, 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 más antiguas, 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 Traffic Director 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.