Error Handling Flows

A custom Flow to handle all errors or log errors and send error logs to a destination of your choosing, e.g. DataDog, Slack, etc.

This is the best way to log or send errors of all Flows to a destination of your choosing, e.g. DataDog or Splunk.

Error Handling Flows are triggered each time an error occurs in any Flow that contains the Error Handling Flow. It can use variables to reference to the error and the Flow itself. Thus error logging is defined once and then applied for all the Flows you chose.

An error handling Flow can be any Flow that handles dynamic data from an error. It could for example send the data to a monitoring service such as Datadog, so that you have all your errors accessible there.

In order to trigger it each time an error occurs, the Flow needs to be added in the Error Handling Flow field of the Flow which should trigger it - accessible via the EDIT button on the Flow builder:

Error Handling Flows will be triggered each time a Flow Step (individual node) has the status error(expect for steps with this setting), even if the Flow Run status is success. Error notifications on the other hand will only be sent when the Flow Run status for the whole run is error as well.

Step specific trigger setting

Depending on the Flow and Error Handling Flow logic it might not make sense to trigger the Error Handling Flow for every Flow Step that might have an error.

For these Steps, triggering the Error Handling Flow can be turned off (default is on):

This setting is only displayed if an Error Handling Flow is selected for the Flow.

Available variables in the Error Handling Flow

You can use any of the following variables in the error handling Flow in order to access all details related to the error.

  • error_flow_id - ID of the Flow having the error

  • error_flow_url - URL of the Flow in the UI

  • error_flow_name - Name of the Flow

  • error_debugging_url - URL of the Flow debugging screen in the UI

  • error_flow_run_id - ID of the Flow Run

  • error_step_name - Name of the Flow Run Step

  • error_step_id - ID of the Flow Run Step

  • error_step_input - Input of the Flow Run Step (as shown in Flow Debugger)

  • error_step_output - Output of the Flow Run Step (as shown in Flow Debugger); this is basically the error message

  • error_step_request_url - The request URL, as shown in the Flow Debugger

  • error_step_response_code - The response code, as shown in the Flow Debugger

  • error_error_date - Time-stamp of the error (end date of step, as shown in the Flow Debugger)

  • error_connector_name - Name of the connector where the error happened

  • error_connector_id - ID of the connector where the error happened

{
  "error_flow_id": "{{ error_flow_id }}",
  "error_flow_url": "{{ error_flow_url }}",
  "error_flow_name": "{{ error_flow_name }}",
  "error_debugging_url": "{{ error_debugging_url }}",
  "error_flow_run_id": "{{ error_flow_run_id }}",
  "error_step_name": "{{ error_step_name }}",
  "error_step_id": "{{ error_step_id }}",
  "error_step_input": "{{ error_step_input }}",
  "error_step_output": "{{ error_step_output }}",
  "error_step_request_url": "{{ error_step_request_url }}",
  "error_step_response_code": "{{ error_step_response_code }}",
  "error_error_date": "{{ error_error_date }}",
  "error_connector_name": "{{ error_connector_name }}",
  "error_connector_id": "{{ error_connector_id }}"
}

Additionally, you can make the outputs of the Flow steps available in the Error Handling Flow.

If a Flow has an Error Handling Flow each step of the Flow has a setting Accessible in Error Handling Flow (OFF by default).

When the setting is ON the output of the Step will be available in the Error Handling Flow.

If the toggle is ON for the Looper Helper only the output of the whole Looper will be available in the Error Handling Flow (not the outputs of the single Looper Steps).

Last updated