Notification Flood Control
Notification flood control prevents users from being flooded with multiple notifications from an integration when they've already been notified about an incident and are working on resolving the issue. You can use this feature to control the maximum number of notifications that are delivered to specific device types during a defined period, such as: no more than two messages every ten minutes to SMS and mobile app devices.
Notification flood control is a company-level setting that applies only to individual integrations which have it enabled. The default configuration settings for this feature limit notifications to one message every three hundred seconds (or one message every five minutes) to mobile app, SMS, and voice device types.
For example, imagine that an incident occurs that triggers an integration in xMatters. You receive a notification on the mobile app, but before you can address the problem, the incident causes something of a chain reaction in your system, setting off multiple incidents that all trigger the same integration. Luckily, you already enabled notification flood control on that integration to limit notifications to mobile app and SMS devices to no more than two messages every ten minutes.
So, while it takes you half-an-hour to resolve the original incident and get your system back to normal, you only receive a couple of messages every ten minutes on your mobile app - allowing you to keep an eye on the overall progress of the incident while still being able to deal with the problem at hand. You can check your email later to see all of the messages that xMatters sent in response to the incidents, but you don't have to deal with them in the heat of the moment.
This section describes how to configure company-level flood control settings which are applied to individual inbound and built-in integrations that have notification flood control enabled. For instructions on how to enable notification flood control for your integrations, see Enable notification flood control.
- Click the Developer tab.
- On the Communication Plan Builder menu, click Flood Control.
- If you have not previously changed your company's flood control configuration settings, they will be set to the default values.
- Specify your notification flood control configuration settings.
- Notification Limit: The maximum number of notifications to be sent for an integration during the suppression duration.
- Suppression Duration: The time period during which additional notifications are suppressed, after the notification limit has been reached.
- Device Types: The device types that flood control applies to (email, mobile apps, SMS, and voice). Notifications to other device types are still delivered.
- Click Save.
When enabled for an integration, notification flood control applies to notifications that target users directly, via subscriptions, or through activity updates. If a user previously received notifications from an integration by any of these methods, xMatters will suppress any additional notifications from these methods that exceed the specified flood control settings for the selected device types.
Notification flood control also overrides the 'Allow Duplicates' setting for groups, suppressing duplicate notifications sent to the same device type of a particular user based on their membership in more than one group.
If xMatters fails to deliver a notification, it will automatically try again; retries are not suppressed, even if they would otherwise be subject to notification flood control.
The Events report and Log audit report indicate events where notifications were suppressed. See Events Report for more information.
By default, notification flood control is disabled for all integrations. You must enable notification flood control for individual inbound or built-in integrations. The following sections describe how to enable notification flood control for these integrations.
You can enable notification flood control for inbound integrations that use the form.post method to trigger a form. This includes 'Create a new xMatters event' and 'Transform content to create a new xMatters event' inbound integrations.
Notification suppression does not apply to inbound integrations that use HTTP POST to call a form from inside an Integration Builder script.
To enable notification flood control for an inbound integration:
- On the Integration Builder tab, expand the list of inbound integrations.
- From the Settings drop-down list (the gear icon) beside an integration, select or clear the check box for Flood Control.
Notification flood control can be enabled for built-in integrations in the Integration Directory.
To enable or disable flood control for an built-in integration configuration:
- In the Integration Directory, on the Configured tab, click the Configurations button for an integration.
- Click the Options button beside a configuration then select or clear the check box for Flood Control.