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

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

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

• Registros de auditoría de actividad del administrador
• Registros de auditoría de acceso a los datos
• Registros de auditoría de eventos del sistema
• Registros de auditoría de política denegada

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:

• Registro de auditoría de flujos de trabajo
• Registro de auditoría para ejecuciones de flujos de trabajo

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 la supervisión representa una entidad física o lógica, 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 con el recurso.

Para ver todos los tipos de recursos, consulta Tipos de recursos supervisados. Para ver todos los tipos de métricas, consulta Métricas de Google Cloud. Expande lo siguiente para ver una lista de los tipos de métricas que se envían desde Workflows a Google Cloud Observability:

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 aprender a leer los datos de tus métricas, consulta Cómo recuperar 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á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 de tu 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 muestran y que se aplique a tu uso. Debe tener el formato de una cadena de 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 muestran y que se aplique 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 colapsado del Explorador de APIs, puedes hacer clic en Pantalla completa fullscreen para expandir el Explorador de APIs. El panel de pantalla completa muestra un panel adicional que contiene muestras de código, respuestas 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?

• Descripción general de la depuración
• Problemas conocidos de Workflows
• Soluciona problemas