Supervisa flujos de trabajo

Google Cloud Observability proporciona herramientas de supervisión, registro y diagnóstico. Estas herramientas pueden ayudarte a supervisar y analizar las implementaciones y ejecuciones de flujos de trabajo, y 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 del sistema y de datos a Cloud Logging. Puedes usar los registros recopilados para depurar y solucionar problemas de tus aplicaciones, y obtener estadísticas sobre ellas.
  • Enviar métricas del sistema y de recursos a Cloud Monitoring Puedes usar las métricas recopiladas para supervisar el estado y el rendimiento, identificar tendencias y problemas, y notificar cambios de comportamiento.

Envía registros de auditoría a Cloud Logging

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

Estos registros están inhabilitados de forma predeterminada, ya que pueden ser bastante extensos. Para obtener más información, consulta Habilita los registros de auditoría de acceso a los datos.

Para obtener más información sobre los registros de auditoría en Workflows, consulta lo siguiente:

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

Envía métricas a Cloud Monitoring

Workflows envía datos de métricas de los recursos supervisados a Google Cloud Observability. Un recurso supervisado 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 supervisados contienen un conjunto único de métricas que se pueden explorar, informar a través de un panel o usar para crear alertas. Cada recurso también tiene un conjunto de etiquetas de recursos, que son pares clave-valor que contienen información adicional sobre el recurso. Las etiquetas de recursos 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, consulta Google Cloud métricas. Expande lo siguiente para ver una lista de los tipos de métricas que se envían desde Workflows a Google Cloud Observability:

Tipos de métricas de Workflows

Lee datos de métricas

Puedes leer datos de métricas, también llamados datos de series temporales, con el método timeSeries.list en la API de Cloud Monitoring. Existen varias formas de llamar al método, como usar una biblioteca cliente específica del 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 Métricas, series temporales y recursos. Para obtener información sobre cómo leer tus datos de métricas, consulta Recupera datos de series temporales.

Supervisa las métricas de cuota

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

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

  2. Si no ves el panel Try this method, haz clic en Try it!.

  3. En el campo name, ingresa el ID de tu proyecto Google Cloud con el siguiente formato:

    projects/PROJECT_ID

  4. En el campo filter, especifica un solo tipo de métrica y, de manera opcional, 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, ingresa una hora de finalización para limitar la cantidad de datos que se muestran y que son aplicables 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, ingresa una fecha y hora de inicio para limitar la cantidad de datos que se muestran y que son aplicables a tu uso. Debe tener el formato de una cadena RFC 3339; por ejemplo, 2024-11-07T03:01:00Z.

  7. Haz clic en Ejecutar.

    El resultado debería ser similar al siguiente, con 350 que 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 expandir el Explorador de APIs. El panel de pantalla completa muestra un panel adicional que contiene muestras de código, respuestas de application/json y respuestas HTTP sin procesar. Por ejemplo, en este caso, puedes 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

Usa los paneles y las alertas de Monitoring

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

Para supervisar estas métricas en Monitoring, puedes crear paneles personalizados. También puedes agregar alertas en función de estas métricas.

¿Qué sigue?