Monitorizar flujos de trabajo

Google Cloud Observability ofrece herramientas de monitorización, registro y diagnóstico. Estas herramientas pueden ayudarte a monitorizar y analizar las implementaciones y ejecuciones de flujos de trabajo, así como a comprender el comportamiento, el estado y el rendimiento de tus aplicaciones.

De forma predeterminada, Workflows está configurado para hacer lo siguiente:

  • Envía registros de auditoría de datos y del sistema a Cloud Logging. Puedes usar los registros recogidos para depurar, solucionar problemas y obtener información valiosa sobre tus aplicaciones.
  • Envía métricas del sistema y de los recursos a Cloud Monitoring. Puedes usar las métricas recogidas para monitorizar el estado y el rendimiento, identificar tendencias y problemas, y enviar notificaciones sobre los cambios en el comportamiento.

Enviar registros de auditoría a Cloud Logging

Workflows envía los siguientes tipos de datos de registro de auditoría a Cloud Logging:

Los registros de auditoría de acceso a datos están inhabilitados de forma predeterminada porque pueden ser bastante grandes. Para obtener más información, consulta el artículo sobre cómo habilitar registros de auditoría de acceso a datos.

Para obtener más información sobre los registros de auditoría de Workflows, consulta los siguientes artículos:

También puedes enviar registros de ejecución a Cloud Logging.

Enviar métricas a Cloud Monitoring

Workflows envía datos de métricas de los recursos monitorizados a Google Cloud Observability. Un recurso monitorizado en Monitoring representa una entidad lógica o física, como una máquina virtual, una base de datos o una aplicación. Los recursos monitorizados contienen un conjunto único de métricas que se pueden explorar, registrar en un panel o usar para crear alertas. Cada recurso también tiene un conjunto de etiquetas de recurso, que son pares clave-valor que contienen información adicional sobre el recurso. Las etiquetas de recurso están disponibles para todas las métricas asociadas al recurso.

Para ver todos los tipos de recursos, consulta Tipos de recursos supervisados. Para ver todos los tipos de métricas, consulte las Google Cloud métricas. Despliega la siguiente lista para ver los tipos de métricas que se envían desde Workflows a Google Cloud Observability:

Tipos de métricas de Workflows

Leer datos de métricas

Puedes leer datos de métricas, también llamados datos de series temporales, mediante el método timeSeries.list de la API Cloud Monitoring. Hay varias formas de llamar al método, como usar una biblioteca de cliente específica de un lenguaje o crear un gráfico con el Explorador de métricas.También puedes probar el método timeSeries.list con el Explorador de APIs basado en formularios. Para obtener una introducción a las métricas y las series temporales, consulta el artículo Métricas, series temporales y recursos. Para saber cómo leer los datos de las métricas, consulta Recuperar datos de serie temporal.

Monitorizar métricas de cuotas

En el siguiente ejemplo se muestra cómo usar el Explorador de APIs para consultar la cuota de asignación total consumida de Workflows. En concreto, usa la métrica serviceruntime.googleapis.com/quota/allocation/usage en el tipo de recurso Consumer Quota. Puede definir filtros de etiquetas adicionales (service y quota_metric) para especificar el tipo de cuota. Para obtener más información sobre cómo monitorizar métricas de cuota, incluidos más ejemplos y cómo crear políticas de alertas, consulta Representar gráficamente y monitorizar métricas de cuota.

  1. Abre la timeSeries.list página de referencia.

  2. Si no ves el panel Prueba este método, haz clic en Probar.

  3. En el campo name (nombre), introduce el ID de tu proyecto Google Cloud con el siguiente formato:

    projects/PROJECT_ID

  4. En el campo Filtro, especifique un solo tipo de métrica y, opcionalmente, etiquetas de métrica y otra información. Por ejemplo:

    metric.type = "serviceruntime.googleapis.com/quota/allocation/usage" AND resource.labels.service = "workflowexecutions.googleapis.com"

  5. En el campo interval.endTime, introduce una hora de finalización para limitar la cantidad de datos que se devuelven, lo que se aplica a tu uso. Debe tener el formato de una cadena RFC 3339; por ejemplo, 2024-11-07T03:01:02Z.

  6. En el campo interval.startTime, introduce una hora de inicio para limitar la cantidad de datos que se devuelven, que se aplica a tu uso. Debe tener el formato de una cadena RFC 3339. Por ejemplo, 2024-11-07T03:01:00Z.

  7. Haz clic en la opción para ejecutar.

    El resultado debería ser similar al siguiente, donde 350 indica la métrica de cuota de ejecuciones simultáneas.

    {
"timeSeries": [
   {
      "metric": {
      "labels": {
         "quota_metric": "workflowexecutions.googleapis.com/concurrency"
      },
      "type": "serviceruntime.googleapis.com/quota/allocation/usage"
      },
      "resource": {
      "type": "consumer_quota",
      "labels": {
         "service": "workflowexecutions.googleapis.com",
         "project_id": "PROJECT_ID",
         "location": "europe-west1"
      }
      },
      "metricKind": "GAUGE",
      "valueType": "INT64",
      "points": [
      {
         "interval": {
            "startTime": "2024-11-07T03:01:02Z",
            "endTime": "2024-11-07T03:01:02Z"
         },
         "value": {
            "int64Value": "350"
         }
      }
      ]
   }

  8. En el panel lateral contraído del Explorador de APIs, puedes hacer clic en Pantalla completa para ampliar el Explorador de APIs. El panel a pantalla completa muestra un panel adicional que contiene ejemplos de código, respuestas application/json y respuestas HTTP sin formato. Por ejemplo, en este caso, puede ver el comando curl comparable:

    curl \
'https://monitoring.googleapis.com/v3/projects/PROJECT_ID/timeSeries?filter=metric.type%20%3D%20%22serviceruntime.googleapis.com%2Fquota%2Fallocation%2Fusage%22%20AND%20resource.labels.service%20%3D%20%22workflowexecutions.googleapis.com%22&interval.endTime=2024-11-07T03%3A01%3A02Z&interval.startTime=2024-11-07T03%3A01%3A00Z&key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --compressed

Usar paneles de control y alertas de Monitoring

Puede usar los paneles de control de Monitoring y sus gráficos asociados para visualizar los datos de las métricas de Workflows.

Para monitorizar estas métricas en Monitoring, puede crear paneles de control personalizados. También puede añadir alertas basadas en estas métricas.

Siguientes pasos