Notifiers#

IXpect notifiers are be used to forward events issued by probes to external systems via email or HTTP callout. Notifications are collected into batches in periodic intervals defined by the event.collection_window setting:

event:
  collection_window: 1min

The following notifiers are available:

• Email
• HTTP
  • Matrix
  • Slack
• Log

Channels and Filtering#

Most notifiers support different channels with custom even filters to route events to different destinations. Empty event filter lists will handled as catch-all.

event:
  notifiers:
    email:
      enable: true
      smtp:
        host: mailout.example.net
        port: 25
      from: noreply+ixpect@example.net
      channels:
        # send important events to the NOC
        - to: alert@example.net
          events:
            - ARP_NEIGHBOR_UNKNOWN
            - IPV6_NEIGHBOR_UNKNOWN
        # catch-all
        - to: bulk@example.net

Customizing Notifications#

Notifications can be customized per notifier by changing the Minijinja templates located in the templates directory.

Testing Notifiers#

The notifier configuration you can be tested by sending a USR1 signal to IXpect. This will generate a dedicated TEST event which needs to be handled by the corresponding channel filters.