Chapter 31. Alerts and Notification
|No failure notification|
|Types of failures|
The Alerts and Notification tab allows setting the condition when a trigger (Schedule, Data Service endpoint or Event Listener) is marked as failing. You can also set up email notifications for the failures here.
No failure notification
The Never mark trigger as failing option disables the failure notification in the Server UI. If you set this option and the trigger fails, it will not be marked as failing. However, the number of failures for Data Services and Event Listeners will be incremented.
Figure 31.1. Never mark trigger as failing option chosen
The Any failure will mark trigger as failing option considers the trigger failing even if a single failure occurs.
This choice is suitable for infrequently running triggers.
Figure 31.2. Data Service - Alerts and Notification
You can set threshold to
- any failure
- percentage of unsuccessful executions within a time interval
- fixed number of failures in a row
The Mark trigger as failing when option sets the trigger as failing when a threshold is reached. The threshold can be specified as a percentage of failing executions or as a number of failing executions in a row.
This choice is suitable for frequently running triggers.
Figure 31.3. Data Service - Alerts and Notification
For Data Services, you can also select HTTP status codes which should be considered by CloverDX Server as an endpoint invocation failure.
Select the HTTP status codes by entering individual codes or ranges of codes separated by commas. By default, codes 404, 500, 501, 502 and 504-599 are considered as an endpoint invocation failure. Leaving the field blank means that CloverDX Server considers all HTTP status codes from the range 400-599 as invocation failure.
By default, CloverDX Server does not consider HTTP status code 503 as a failure, because the code is returned in the case of invocation of a manually disabled endpoint.
Types of failures:
- all triggers fail when the executed task fails
- a File Event Listener also fails when checking the file system fails (e.g. insufficient permissions, non-existing directory, bad credentials)
- a JMS Message Listener also fails when the JMS connection fails (e.g. classpath issue, wrong credentials)
- a Universal Event Listener also fails when the triggering Groovy code fails
- a Data Service also fails when it returns a 4xx or 5xx HTTP status code
If a trigger fails, it is shown in the table of Schedules, Data Services or Event Listeners, respectively. Additionally, the number of failing triggers is shown in the main menu.
Figure 31.4. Some Data Service is failing
You can also set an email notification. This email notification works additionally to the notification in the Server UI. It sends an email when the health state of a trigger changes. An email is also sent if the trigger was failing and you manually reset its health state.
Figure 31.5. E-mail Notification
With thebutton, you can send a testing email to the addresses of the recipients.
Email notifications require a working connection to an SMTP server.