Monitorare i workflow

Google Cloud Observability fornisce strumenti di monitoraggio, logging e diagnostica. Questi strumenti possono aiutarti a monitorare e analizzare le implementazioni e le esecuzioni dei workflow 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 log di controllo dei dati e del sistema a Cloud Logging. Puoi utilizzare i log raccolti per eseguire il debug, risolvere i problemi e ottenere informazioni sulle tue applicazioni.
  • Invia le metriche di sistema e delle risorse a Cloud Monitoring. Puoi utilizzare le metriche raccolte per monitorare l'integrità e il rendimento, identificare tendenze e problemi e inviare notifiche per le modifiche del comportamento.

Inviare audit log a Cloud Logging

Workflows invia i seguenti tipi di dati dei log di controllo a Cloud Logging:

Gli audit log di accesso ai dati sono disabilitati per impostazione predefinita perché possono essere abbastanza grandi. Per ulteriori informazioni, consulta la pagina Abilitare gli audit log di accesso ai dati.

Per saperne di più sui log di controllo in Workflows, consulta quanto segue:

Puoi anche inviare i log di esecuzione a Cloud Logging.

Inviare 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, riportate 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 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, ad esempio utilizzando una libreria client specifica per la lingua o creando 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 di quota

L'esempio seguente mostra come utilizzare Explorer API per eseguire query sulla quota di allocazione totale consumata per Workflows. Nello specifico, 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 (nome), 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, 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 orario 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 orario di inizio per limitare la quantità di dati restituiti e applicabili al tuo utilizzo. Deve essere formattato come una 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 di esecuzione simultanea.

    {
"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 pannello a schermo intero mostra un riquadro aggiuntivo contenente esempi di codice, risposte application/json e risposte HTTP non elaborate. Ad esempio, in questo caso, <x0A>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

Utilizzare le dashboard e gli avvisi di Monitoring

Puoi utilizzare le dashboard di monitoraggio e i relativi grafici 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