Monitorare i workflow

Google Cloud Observability fornisce strumenti di monitoraggio, logging e diagnostica. Questi strumenti possono aiutarti a monitorare e analizzare i deployment e le esecuzioni dei flussi di lavoro e a comprendere il comportamento, l'integrità e le prestazioni delle tue applicazioni.

Per impostazione predefinita, Workflows è configurato per eseguire le seguenti operazioni:

  • Invia i dati e gli audit log di sistema a Cloud Logging. Puoi utilizzare i log raccolti per eseguire il debug, risolvere i problemi e ottenere insight sulle tue applicazioni.
  • Invia le metriche di sistema e delle risorse a Cloud Monitoring. Puoi utilizzare le metriche raccolte per monitorare l'integrità e le prestazioni, identificare tendenze e problemi e inviare notifiche in caso di variazioni del comportamento.

Inviare i log di controllo a Cloud Logging

Workflows invia i seguenti tipi di dati degli audit log a Cloud Logging:

I log di controllo dell'accesso ai dati sono disabilitati per impostazione predefinita perché possono essere piuttosto grandi. Per saperne di più, consulta Abilita i log di controllo dell'accesso ai dati.

Per saperne di più sugli audit log in Workflows, consulta quanto segue:

Puoi anche inviare i log di esecuzione a Cloud Logging.

Invia metriche a Cloud Monitoring

Workflows invia i dati delle metriche dalle risorse monitorate a Google Cloud Observability. Una risorsa monitorata in Monitoring rappresenta un'entità logica o fisica, ad esempio una macchina virtuale, un database o un'applicazione. Le risorse monitorate contengono un insieme unico di metriche che possono essere esplorate, segnalate tramite una dashboard o utilizzate per creare avvisi. Ogni risorsa ha anche un insieme di etichette delle risorse, ovvero coppie chiave-valore che contengono informazioni aggiuntive sulla risorsa. Le etichette delle risorse sono disponibili per tutte le metriche associate alla risorsa.

Per visualizzare tutti i tipi di risorse, consulta Tipi di risorse monitorate. Per visualizzare tutti i tipi di metriche, consulta Metriche diGoogle Cloud . Espandi quanto segue per visualizzare un elenco dei tipi di metriche inviati da Workflows a Google Cloud Observability:

Tipi di metriche di Workflows

Lettura dei dati delle metriche

Puoi leggere i dati delle metriche, chiamati anche dati delle serie temporali, utilizzando il metodo timeSeries.list nell'API Cloud Monitoring. Esistono diversi modi per chiamare il metodo, tra cui l'utilizzo di una libreria client specifica per il linguaggio o la creazione di un grafico con Esplora metriche.Puoi anche provare il metodo timeSeries.list utilizzando Explorer API basato su moduli. Per un'introduzione alle metriche e alle serie temporali, consulta Metriche, serie temporali e risorse. Per scoprire come leggere i dati delle metriche, consulta Recuperare i dati delle serie temporali.

Monitorare le metriche delle quote

L'esempio seguente mostra come utilizzare Explorer API per eseguire query sulla quota di allocazione totale utilizzata per Workflows. In particolare, utilizza la metrica serviceruntime.googleapis.com/quota/allocation/usage sul tipo di risorsa Consumer Quota. Puoi impostare filtri per le etichette aggiuntivi (service, quota_metric) per specificare il tipo di quota. Per saperne di più su come monitorare le metriche di quota, inclusi ulteriori esempi e come creare policy di avviso, consulta Creare grafici e monitorare le metriche di quota.

  1. Apri la timeSeries.list pagina di riferimento.

  2. Se il riquadro Prova questo metodo non è visibile, fai clic su Prova.

  3. Nel campo name, inserisci l'ID progetto Google Cloud utilizzando il seguente formato:

    projects/PROJECT_ID

  4. Nel campo filtro, specifica un singolo tipo di metrica e, facoltativamente, le etichette della metrica e altre informazioni. Ad esempio:

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

  5. Nel campo interval.endTime, inserisci un'ora di fine per limitare la quantità di dati restituiti e applicabili al tuo utilizzo. Deve essere formattato come stringa RFC 3339, ad esempio 2024-11-07T03:01:02Z.

  6. Nel campo interval.startTime, inserisci un'ora di inizio per limitare la quantità di dati restituiti e applicabili al tuo utilizzo. Deve essere formattata come stringa RFC 3339, ad esempio 2024-11-07T03:01:00Z.

  7. Fai clic su Esegui.

    Il risultato dovrebbe essere simile al seguente, con 350 che indica la metrica della quota per le esecuzioni in parallelo.

    {
"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. Nel riquadro laterale compresso di Explorer API, puoi fare clic su Schermo intero per espandere Explorer API. Il riquadro a schermo intero mostra un riquadro aggiuntivo contenente esempi di codice, risposte application/json e risposte HTTP non elaborate. Ad esempio, in questo caso, puoi visualizzare il comando curl comparabile:

    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

Utilizza le dashboard e gli avvisi di Monitoring

Puoi utilizzare le dashboard di Monitoring e i grafici associati per visualizzare i dati delle metriche di Workflows.

Per monitorare queste metriche in Monitoring, puoi creare dashboard personalizzate. Puoi anche aggiungere avvisi in base a queste metriche.

Passaggi successivi