A plugin for Nagios and compatible software (e.g. Icinga) to enable notifications to a Mattermost server.

Run ./mattermost.py --help for full usage information.

1. Incoming Webhooks must be enabled for your Mattermost server. Check the Enable Incoming Webhooks option under Service Settings in the System Console.

2. To use the optional --username parameter you must enable overriding of usernames from webhooks. Check the Enable Overriding Usernames from Webhooks and Slash Commands option under Service Settings in the System Console.

3. To use the optional --iconurl parameter you must enable overriding of icons from webhooks. Check the Enable Overriding Icon from Webhooks and Slash Commands option under Service Settings in the System Console.

The steps below are for a Nagios 4 server but should work with minimal modifications for compatible software:

1. Copy mattermost.py to /usr/local/nagios/libexec.

2. Create an Incoming Webhook integration for the approriate team and note the provided URL.

3. copy configuration mattermost.cfg to /etc/nagios4/conf.d/ and upgrade parameter <MATTERMOSTE_URL>, <MATTERMOSTE_CHANNEL> and <NAGIOS_CGIURL>

4. Add the contact to a contact group in your Nagios configuration:

define contactgroup{
    contactgroup_name       network-admins
    alias                   Network Administrators
    members                 email, mattermost
}