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:

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:

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

Le stringhe "tipo di metrica" in questa tabella devono essere precedute dal prefisso workflows.googleapis.com/. Questo prefisso è stato omesso dalle voci della tabella. Quando esegui una query su un'etichetta, utilizza il prefisso metric.labels.; ad esempio, metric.labels.LABEL="VALUE".

Tipo di metrica Fase di lancio (Livelli della gerarchia delle risorse)
Nome visualizzato
Tipo, Tipo, Unità
Risorse monitorate		 Descrizione
Etichette
await_callback_step_count GA  (progetto)
Await Callback Step Count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di passaggi eseguiti che attendono un callback. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
callback_requests_count GA  (progetto)
Conteggio richieste di richiamata
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di richieste effettuate per attivare un callback. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
callback_timeout_count GA  (progetto)
Conteggio timeout callback
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di richiamate per cui è stato raggiunto il timeout. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
cmek_protected_workflow_count GA  (progetto)
Conteggio workflow protetti tramite CMEK
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di workflow di cui è stato eseguito il deployment con la protezione CMEK. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
compute_slice_count GA  (progetto)
Conteggio slice di Compute
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di slice di calcolo eseguiti. I passaggi vengono eseguiti in sezioni di lavoro, a seconda del tipo di passaggi eseguiti (ad es. le richieste HTTP vengono eseguite separatamente dai passaggi "assegna"). Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
type: Il tipo di slice di calcolo, ad esempio "IO_REQUEST" o "WAKEUP".
has_parallel: (BOOL) Indica se il flusso di lavoro utilizza passaggi paralleli.
compute_slice_latencies GA  (progetto)
Latenze delle sezioni di calcolo
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latenze dal momento in cui è stata pianificata una sezione di calcolo al momento in cui è stata eseguita. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
type: Il tipo di slice di calcolo, ad esempio "IO_REQUEST" o "WAKEUP".
has_parallel: (BOOL) Indica se il flusso di lavoro utilizza passaggi paralleli.
compute_step_count GA  (progetto)
Conteggio passi di Compute
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di passaggi di calcolo eseguiti (ad es. passaggi "assegna" e "for"). Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
compute_step_latencies GA  (progetto)
Latenze dei passaggi di calcolo
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latenze dei passaggi di calcolo eseguiti. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
create_callback_step_count GA  (project)
Create Callback Step Count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di passaggi eseguiti che creano un callback. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
method: Il tipo di metodo del callback creato, ad esempio "POST".
deployment_attempt_count GA  (progetto)
Conteggio tentativi di deployment
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di tentativi di deployment del flusso di lavoro. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
result: Lo stato dei tentativi di deployment.
deployment_latencies GA  (project)
Deployment Latencies
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latenze dei tentativi di deployment del flusso di lavoro. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
duplicate_event_count GA  (progetto)
Conteggio eventi duplicati
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di attivazioni di eventi duplicati ricevute. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
event_type: Il tipo di evento.
event_time_to_ack_latencies GA  (progetto)
Latenze di conferma dell'ora dell'evento
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latenze dal momento in cui inizia un evento al momento in cui il servizio dei workflow lo riconosce. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
event_type: Il tipo di evento.
event_trigger_count GA  (progetto)
Conteggio trigger evento
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di attivazioni di eventi ricevute. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
event_type: Il tipo di evento.
result: Il risultato dell'attivazione dell'evento.
execution_backlog_size GA  (project)
Execution Backlog Size
GAUGE, INT64, 1
workflows.googleapis.com/Workflow 		Numero di esecuzioni non ancora avviate. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
execution_times BETA  (progetto)
Tempi di esecuzione
DELTA, DISTRIBUTION, s
workflows.googleapis.com/Workflow 		Distribuzione dei tempi di esecuzione del workflow.
revision_id: L'ID revisione del workflow eseguito.
external_step_count BETA  (progetto)
Conteggio passi esterno
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Conteggio dei passaggi esterni eseguiti per il flusso di lavoro.
finished_execution_count BETA  (progetto)
Conteggio esecuzioni completate
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Conteggio delle esecuzioni completate per il flusso di lavoro.
status: Lo stato di esecuzione del flusso di lavoro.
revision_id: L'ID revisione del workflow eseguito.
internal_execution_error_count GA  (progetto)
Conteggio errori di esecuzione interni
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di esecuzioni non riuscite a causa di un errore interno. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
internal_step_count BETA  (progetto)
Conteggio passi interno
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Conteggio dei passaggi interni eseguiti per il flusso di lavoro.
io_internal_request_count GA  (project)
IO Internal Request Count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di richieste I/O effettuate da un flusso di lavoro ai servizi Google. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
service_domain: Il dominio del servizio Google chiamato, ad esempio "bigquery.googleapis.com".
io_step_count GA  (project)
IO Step Count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di passaggi I/O eseguiti. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
io_result: Il risultato del passaggio I/O.
io_step_type: Il tipo di passaggio I/O.
destination_type: Il tipo di destinazione del passaggio di I/O.
had_system_error: (BOOL) Indica se il passaggio I/O ha generato un errore di sistema.
io_step_latencies GA  (project)
IO Step Latencies
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latenze dei passaggi I/O eseguiti. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
io_result: Il risultato del passaggio I/O.
io_step_type: Il tipo di passaggio I/O.
had_system_error: (BOOL) Indica se il passaggio I/O ha generato un errore di sistema.
kms_decrypt_latencies GA  (progetto)
Latenze di decrittografia KMS
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latenze delle richieste di decriptaggio a KMS da parte dei workflow per CMEK. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
status: Lo stato delle richieste di decrittografia.
attempts: (INT64) Il conteggio dei tentativi delle richieste di decrittografia.
kms_decrypt_request_count GA  (progetto)
Conteggio richieste di decrittografia KMS
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di richieste di decrittografia KMS effettuate dal servizio per CMEK. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
status: Lo stato delle richieste di decrittografia.
kms_encrypt_latencies GA  (progetto)
Latenze di crittografia KMS
DELTA, DISTRIBUTION, ms
workflows.googleapis.com/Workflow 		Latenze delle richieste di crittografia a KMS da parte dei workflow per CMEK. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
status: Lo stato delle richieste di crittografia.
attempts: (INT64) Il conteggio dei tentativi delle richieste di crittografia.
kms_encrypt_request_count GA  (progetto)
Conteggio richieste di crittografia KMS
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di richieste di crittografia KMS effettuate dal servizio per CMEK. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
status: Lo stato delle richieste di crittografia.
parallel_branch_step_count GA  (progetto)
Conteggio passaggi del ramo parallelo
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di passaggi eseguiti utilizzando rami paralleli. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
parallel_branch_substep_count GA  (progetto)
Conteggio dei passaggi secondari del ramo parallelo
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di passaggi eseguiti all'interno di rami paralleli. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
parallel_iteration_step_count GA  (project)
Parallel iteration step count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di passaggi eseguiti utilizzando iterazioni parallele. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
parallel_iteration_substep_count GA  (project)
Parallel iteration substep count
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di passaggi eseguiti all'interno delle iterazioni parallele. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
parallel_unhandled_exceptions_limit_count GA  (progetto)
Conteggio limite delle eccezioni parallele non gestite
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di volte in cui è stato raggiunto il limite di eccezioni parallele non gestite. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
pending_io_requests GA  (progetto)
Richieste IO in attesa
GAUGE, INT64, 1
workflows.googleapis.com/Workflow 		Numero di richieste I/O in corso. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
sent_bytes_count BETA  (progetto)
Byte di rete inviati
DELTA, INT64, By
workflows.googleapis.com/Workflow 		Conteggio dei byte HTTP in uscita (URL, intestazioni e corpo) inviati dal flusso di lavoro.
revision_id: L'ID revisione del workflow eseguito.
started_execution_count BETA  (progetto)
Conteggio esecuzioni avviate
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Conteggio delle esecuzioni avviate per il flusso di lavoro.
revision_id: L'ID revisione del workflow eseguito.
started_vpcsc_executions_count GA  (progetto)
Conteggio esecuzioni VPC-SC avviate
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di esecuzioni con limitazioni VPC-SC avviate. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.
vpcsc_protected_io_count GA  (progetto)
Conteggio I/O protetti da VPC-SC
DELTA, INT64, 1
workflows.googleapis.com/Workflow 		Numero di richieste I/O effettuate utilizzando VPC-SC. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
revision_id: L'ID revisione del workflow eseguito.

Tabella generata il giorno 2025-08-28 alle ore 21:10:54 UTC.

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 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, 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