This documentation is related to openITCOCKPIT 4
This module provides a Two-Way integration of Mattermost into openITCOCKPIT. Alerts can be send out via Mattermost. And Acknowledgements can be sent from Mattermost to openITCOCKPIT.
Under "API / Mattermost" you can find the settings for the Mattermost module.
Defines the address of the Mattermost server to which the module sends the notifications
|Enable Two-Way Integration|
Via the Two-Way Integration Mattermost is able, to acknowledge host and service problems.
For this option it is required, that your openITCOCKPIT Server is accessible from the Mattermost Server.
|openITCOCKPIT API Key|
This API Key will be used by Mattermost to send the acknowledge commands
You need to create an openITCOCKPIT user defined API key first.
|Use Proxy Server||Determine if the configured proxy should be used|
Create a new Bot Account (or normal user) for openITCOCKPIT in your Mattermost installation.
In the next setp create a new Incoming Webhook.
If you click on "Save" the system will display the Webhook URL. For Example:
If you are using a private IP-Addresses make sure to add the Network or IP-Address of your openITCOCKPIT Server into AllowedUntrustedInternalConnections in your Mattermost's config.json.
See also: Allow untrusted internal connections to
To use self-signed certificates you have to enable EnableInsecureOutgoingConnections in your Mattermost's config.json.
See also: Enable Insecure Outgoing Connections
Open the Mattermost Module Configuration and fill out the required fields.
The following commands must be used for the notification.
However, these should already have been created during the module installation.
/opt/openitc/frontend/bin/cake MattermostModule.mattermost_notification --type Host --notificationtype "$NOTIFICATIONTYPE$" --hostuuid "$HOSTNAME$" --state "$HOSTSTATEID$" --output "$HOSTOUTPUT$" --ackauthor "$NOTIFICATIONAUTHOR$" --ackcomment "$NOTIFICATIONCOMMENT$"
/opt/openitc/frontend/bin/cake MattermostModule.mattermost_notification --type Service --notificationtype "$NOTIFICATIONTYPE$" --hostuuid "$HOSTNAME$" --serviceuuid "$SERVICEDESC$" --state "$SERVICESTATEID$" --output "$SERVICEOUTPUT$" --ackauthor "$NOTIFICATIONAUTHOR$" --ackcomment "$NOTIFICATIONCOMMENT$"