🇮🇹 IT

🚨 Error Trigger

L'Error Trigger si attiva automaticamente ogni volta che un altro workflow nel tuo account Flusso incontra un errore di esecuzione fatale. Ti permette di costruire un singolo workflow dedicato alla gestione degli errori che risponde ai fallimenti in tutta la tua configurazione di automazione — inviando avvisi, registrando dettagli o tentando azioni di recupero.

Categoria: Trigger · Identificatore tipo: error_trigger

Panoramica

In qualsiasi sistema automatizzato, i fallimenti sono inevitabili. Un'API esterna potrebbe non essere disponibile, un campo dati potrebbe mancare, o uno step potrebbe produrre un risultato inatteso che causa il crash di un nodo successivo. Senza una strategia di gestione degli errori, questi fallimenti sono silenziosi: potresti non accorgertene finché un cliente non si lamenta o un report risulta mancante.

L'Error Trigger risolve questo problema a livello di piattaforma. Anziché aggiungere logica di gestione degli errori a ogni singolo workflow, crei un unico workflow dedicato di gestione errori che usa l'Error Trigger come primo nodo. Ogni volta che un altro workflow nel tuo account fallisce, questo gestore errori si attiva e riceve tutti i dettagli su cosa è andato storto: quale workflow, quale esecuzione, quale step e il messaggio di errore.

Un tipico workflow di gestione errori potrebbe inviare un messaggio Slack a un canale operativo, creare un task nel tuo strumento di gestione progetti, o inviare un avviso email all'ingegnere di turno. Gestori errori più avanzati possono tentare di rieseguire automaticamente il workflow fallito, o intraprendere azioni compensative (come annullare un ordine parzialmente elaborato) per ripristinare uno stato coerente.

Configurazione

Nessuna configurazione richiesta. Questo trigger si attiva solo in base a eventi esterni — nello specifico, quando un qualsiasi workflow nel tuo account fallisce. Non c'è nulla da configurare.

Dati di Output

L'Error Trigger fornisce informazioni dettagliate sull'esecuzione del workflow fallita:

Variabile	Tipo	Descrizione
`trigger.output.workflow_id`	String (UUID)	L'identificatore univoco del workflow che è fallito.
`trigger.output.workflow_name`	String	Il nome leggibile del workflow che è fallito, come impostato nelle impostazioni del workflow.
`trigger.output.run_id`	String (UUID)	L'identificatore univoco dell'esecuzione specifica che è fallita. Puoi usarlo per cercare l'esecuzione nella vista Monitor.
`trigger.output.step_key`	String	La chiave dello step all'interno del workflow in cui si è verificato l'errore. Corrisponde alla step key mostrata nell'editor del workflow.
`trigger.output.error_message`	String	Il messaggio di errore prodotto dallo step fallito. È lo stesso messaggio mostrato nella vista dettaglio esecuzione nel Monitor.

// Costruisci un messaggio di avviso errore usando tutti i campi disponibili Il workflow "{{ trigger.output.workflow_name }}" è fallito. Step: {{ trigger.output.step_key }} Errore: {{ trigger.output.error_message }} ID Esecuzione: {{ trigger.output.run_id }}

Esempio di Utilizzo

Avviso errore centralizzato su Slack

Crea un singolo workflow che ascolta tutti gli errori nel tuo account e pubblica un avviso su un canale Slack.

Crea un nuovo workflow chiamato "Gestore Errori" e aggiungi un Error Trigger come primo nodo.
Aggiungi un nodo Slack Message. Imposta il canale su #ops-alerts e il messaggio su:
:red_circle: *Workflow fallito* *Workflow:* {{ trigger.output.workflow_name }} *Step:* {{ trigger.output.step_key }} *Errore:* {{ trigger.output.error_message }} *ID Esecuzione:* {{ trigger.output.run_id }}
Imposta il workflow Gestore Errori su Attivo. Ora pubblicherà automaticamente su Slack ogni volta che un altro workflow nel tuo account fallisce.

Orchestrazione di retry automatico

Per workflow che chiamano API esterne instabili, puoi usare l'Error Trigger per tentare un retry automatico tramite l'API Flusso:

Aggiungi un nodo Logic Gate dopo l'Error Trigger. Verifica se trigger.output.workflow_name corrisponde al workflow specifico che vuoi riprovare (così non riprovi ogni workflow fallito).
Nel ramo true, aggiungi un nodo HTTP Request che chiama l'API Flusso per attivare una nuova esecuzione del workflow fallito, passando qualsiasi contesto rilevante.
Nel ramo false, aggiungi un nodo Slack Message per avvisare dei fallimenti in altri workflow che non vengono riprovati automaticamente.

Suggerimenti & Note

Non causare errori nel tuo gestore errori. Se il workflow Error Trigger stesso fallisce (ad esempio, perché l'API Slack è fuori servizio), non attiverà se stesso ricorsivamente — Flusso impedisce ai workflow Error Trigger di attivarsi sui propri fallimenti. Tuttavia, dovresti comunque mantenere i workflow di gestione errori il più semplici e robusti possibile.

Si raccomanda un solo workflow Error Trigger per account. Puoi creare più workflow con Error Trigger, e tutti si attiveranno ad ogni fallimento. Questo può portare ad avvisi duplicati. Di solito è più semplice avere un singolo workflow di gestione errori che usa un nodo Switch per instradare workflow diversi verso azioni diverse.
Si attiva solo per errori fatali. Gli step che vengono saltati con grazia o che restituiscono un risultato vuoto non attivano l'Error Trigger. Si attiva solo quando uno step lancia un'eccezione non gestita che causa il contrassegno dell'esecuzione come fallita.
Il workflow di gestione errori deve essere Attivo per ricevere gli eventi di errore. Un workflow di gestione errori in pausa perderà gli errori che si verificano durante il periodo di pausa.

Nodi Correlati

Emit Event — emette un evento personalizzato con nome da un workflow per attivarne un altro.
Event Trigger — attiva un workflow in base a un evento con nome da un altro workflow.
Stop — termina esplicitamente un'esecuzione del workflow con stato di successo o fallimento.