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 comprender el comportamiento, el estado y el rendimiento de tus aplicaciones.

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

  • Enviar registros de auditoría de datos y del sistema 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:

Los registros de auditoría de acceso a los datos 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 los siguientes recursos:

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 Métricas deGoogle Cloud . 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 los 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 aprender a 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. En particular, 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áficos y supervisión de las métricas de cuota.

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

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

  3. En el campo name, ingresa el ID del proyecto de 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 devuelven y que se aplican 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 hora de inicio para limitar la cantidad de datos que se devuelven 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, en el que 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 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?