Monitorare i flussi di lavoro

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 le prestazioni, 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 del log di controllo a Cloud Logging:

• Audit log delle attività di amministrazione
• Audit log degli accessi ai dati
• Audit log degli eventi di sistema
• Audit log negati da criteri

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

Per ulteriori informazioni sui log di controllo in Workflows, consulta quanto segue:

• Audit logging per i flussi di lavoro
• Audit logging per le esecuzioni dei flussi di lavoro

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:

Lettura dei dati delle metriche

Puoi leggere i dati delle metriche, chiamati anche dati di 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 ulteriori informazioni su come monitorare le metriche di quota, inclusi altri esempi e come creare criteri 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 del tuo 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, applicabile 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 formattato 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 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 fullscreen 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, 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 Monitoring 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

• Panoramica del debug
• Problemi noti per i flussi di lavoro
• Risolvere i problemi