How to build integration flows that send error notifications
You can use the Monitor tab on the Digibee Integration Platform to monitor your integration flows. Currently, there's no feature on the Monitor pages to notify users when an error occurs in their integration flows. However, you can set up your integration flows to notify you when an error occurs. Here’s how you can do it.
If you want to be notified by email of an error in your integration flow, use the EMAIL V2 connector or a capsule that serves a similar purpose, such as the send-email-alert capsule. Include information in the email body that will be useful when troubleshooting, such as:
- Pipeline name
- Pipeline key
- Request data
- Response data
- Part of the pipeline where the error ocurred
- Error code
You can also send error data to an IT Service Management (ITSM) tool, such as ServiceNow or BMC Remedy by using a connector that communicates with external services, such as SOAP V3 or REST V2. If you use this method, you must set the POST request body to conform to the format the chosen service requires.
To send an error alert every time an error occurs, add the desired notification-sending connector or capsule at points in your integration flow where errors are likely to occur, such as when validating data or querying external services or databases.
In the following example, we used an EMAIL V2 connector to send an error notification every time a query to the REST API fails.
Example of a section of a pipeline that sends an error notification by email
You can use an event-driven architecture to periodically send notifications about errors that happened during a certain time interval in your integration flow. To do this:
- 1.Use the Object Store connector in your business rule pipelines to store error data each time an error occurs in your pipelines
- 2.Create a pipeline with a Schedule Trigger that retrieves the error data from the Object Store database and sends it as a notification
If you want to send your error data by email as a CSV file, follow these steps:
- 1.Using the Object Store connector, make a query to the database responsible for storing the error data
Example of a pipeline that sends error summary alerts as a CSV file by email