Using Notifications

The notification system is designed to be highly customizable to configure IguanaX to notify your team using any monitoring system or alerting mechanism you choose - for example, you can have IguanaX notifications sent to your team via an application like Slack, Microsoft Teams, ServiceNow, or have notifications emailed to alert the team of a warning or incident.

Follow along below to configure notifications:

1. Choose a Notifier Component:

You can use any component you wish to receive the triggered log messages and send notifications to your team. For example, you can build a custom component or modify the IguanaX Notifications (email), Slack Notifier Adapter, or ServiceNow Adapter to use as your Notifier component.

2. Create Notification Rules:

Notification rules are created by specifying four criteria:

Every notification rule will have a Matching Rule to assign a notification rule to components. Iguana supports glob expression (*), boolean(and/or), or regular expressions (regex) with Tags to create matching rules. To use regex, simply enclose the expression in slash characters /<regex>/.

IguanaX does not support the V6 bang regex syntax !<regex> use /<regex>/ instead

The table below provides an overview of example pattern matching techniques you can combine to create a matching rule.

Type	Sample	Description

Type	Sample	Description
Wildcard	`*`	Apply to all components.
Wildcard	`#dev*`	Apply to components with #dev followed by 0 or more characters
OR	`#prod #dev`	Apply to components with either #prod or #dev tags.
AND	`"#prod #dev"`	Apply to components with both #prod and #dev tags.
Negation	`-#prod`	Apply to all components without the #prod tag.
Negation	`“#prod -#dev”`	Apply to all components with the #prod tag and without #dev.

Conditions are the notification rule criteria. If a condition is met, a log is generated and sent to the notifier component.

There are four types of conditions used to trigger notifications:

Errors: triggered if an error message is generated in the component(s) logs.
Inactivity: triggered if a component(s) has not processed messages in the specified time (in minutes).
Queue: triggered if a component(s) queue count exceeds the threshold value set.
Log Contains: triggered if a component(s) logs contain a matching pattern. The Log Contains rule is the most flexible type of notification rule as you can leverage default logs generated by Iguana or custom log messages invoked from the Translator (see Custom Logging). The pattern can use strings (ex. component stopped) or regex patterns by enclosing the expression in slash characters /<regex>/.

You can mark a notification rule as low, medium or high based on the criticality of the alert. This value can be mapped to any external incident tracking system of your choice.

You can set a limit to the number of log triggers generated to control the number of notifications sent within a 1 hour period.

The default is set to 6 notifications per hour, the maximum can be set to 60 notifications per hour.

3. Test your Notification Rules: