Puoi recuperare la cronologia di un'esecuzione del workflow specificato come elenco di voci di passaggio. Ogni voce del passaggio fornisce informazioni utili per l'analisi, il debug o l'ottimizzazione di un workflow. Ad esempio, puoi confermare quali passaggi sono stati eseguiti e determinare la durata e l'esito di un passaggio. Ciò può essere particolarmente utile per il debug di un workflow non lineare grande o complicato (ad esempio, uno con molti rami paralleli).
Una voce di passaggio rappresenta un passaggio effettivo nel codice sorgente (ad esempio, assign o call) o un blocco di istruzioni (ad esempio, un ciclo for o un blocco try/retry/except). Per un elenco completo dei tipi di passaggi, consulta
StepType.
Livello della cronologia di esecuzione
Quando crei o esegui un workflow, puoi specificare una cronologia di esecuzione di base o dettagliata. Puoi applicare questa impostazione a livello di workflow o di esecuzione.
Per impostazione predefinita, non viene specificato alcun livello di cronologia di esecuzione e vengono restituite le voci dei passaggi di base.
Se vuoi che la cronologia di esecuzione includa i valori delle variabili nell'ambito e,
se applicabile, il numero previsto di iterazioni (ad esempio, quando utilizzi un ciclo
for o un ramo o un'iterazione paralleli), devi impostare il livello della cronologia
di esecuzione su Dettagliato.
Se per un'esecuzione non viene specificato un livello della cronologia di esecuzione, questo viene determinato dal livello applicato al workflow. Se i livelli sono diversi, l'impostazione applicata a livello di esecuzione sostituisce l'impostazione applicata a livello di workflow per l'esecuzione.
Come recuperare le voci dei passi
Puoi recuperare le voci dei passaggi inviando una richiesta all'API REST Workflow Executions o tramite la console Google Cloud :
Google Cloud console: in questo documento, vedi Visualizza le voci dei passaggi nella console.
Oltre a elencare le voci dei passaggi e i relativi dettagli, la console fornisce una rappresentazione grafica dei passaggi di esecuzione, semplificando la visualizzazione e l'analisi del percorso di esecuzione di un workflow.
API REST Workflow Executions: in questo documento, vedi Recupera una voce di passaggio ed Elenca le voci di passaggio.
Informazioni sull'inserimento del passaggio
Una voce di passo include le seguenti informazioni. Le voci dettagliate dei passi includono anche le informazioni di base.
Per saperne di più, consulta la sezione Esempi di questo documento.
Informazioni di base sull'inserimento dei passi
| Nome | Nome della risorsa completo della voce del passaggio, ovvero un ID univoco con il seguente formato, dove STEPENTRY_ID è un contatore crescente:
|
| Data e ora di creazione e aggiornamento | Timestamp dell'ora di creazione della voce del passaggio e del suo aggiornamento più recente. Se una voce di passaggio è stata completata, updateTime indica
l'ora di completamento.
|
| Nomi di routine e passaggi | I nomi della routine e del passaggio a cui appartiene la voce del passaggio. Il
nome di una routine è il nome del subworkflow definito nel codice sorgente YAML o
JSON. Il nome della routine di primo livello è main.
|
| Stato e tipo di avanzamento | Stato della voce del passaggio, ad esempio se l'operazione è riuscita o non è riuscita oppure se una voce del passaggio è in corso e il tipo di avanzamento. Per un elenco completo di stati e tipi di avanzamento, consulta State e ProgressType. |
| Informazioni di navigazione | Posizione della voce del passaggio in modo da comprendere meglio la gerarchia e il flusso del workflow, ad esempio quali voci del passaggio vengono prima o dopo la voce del passaggio corrente oppure quali sono genitori o figli della voce del passaggio. Per maggiori dettagli, vedi NavigationInfo. |
| Metadati | Dati relativi a una voce di passaggio iterativo, che possono includere quanto segue:
|
| Eccezioni | Payload relativo a eventuali eccezioni e che fornisce una descrizione del motivo per cui una voce di passaggio non è riuscita. |
Informazioni dettagliate sull'inserimento dei passi
| Metadati | Se applicabile, il numero previsto di iterazioni nell'avanzamento
del passaggio, ad esempio quando si utilizza un ciclo Tieni presente che il conteggio calcolato non funzionerà come previsto se i limiti del ciclo includono espressioni che incorporano uno dei seguenti elementi:
|
| Dati variabili | Dati relativi ai valori delle variabili incluse nell'ambito associati a questo passaggio, inclusi i nomi e i valori delle variabili locali definite dall'utente e i risultati delle valutazioni delle espressioni. Tieni presente che l'ambito esclude le variabili interne collegate alle funzioni integrate di Workflows. Per maggiori dettagli, consulta VariableData. |
Visualizza le voci dei passaggi nella console
Puoi visualizzare le voci dei passaggi per una specifica esecuzione del workflow nella consoleGoogle Cloud .
Nella console Google Cloud , vai alla pagina Workflow.