Page tree
Skip to end of metadata
Go to start of metadata

Was kann ich mit dem Slack Modul tun?

Mit Hilfe des Slack Moduls kannst du Benachrichtigungen von openITCOCKPIT direkt in einen Channel deines Slack Workspace bekommen.

Was kann ich konfigurieren?

Unter "Configuration / Slack" sind die Einstellungen für das Slack Modul zu finden.


Feld NameErforderliches FeldBeschreibung
Webhook URL(warning)

Definiert die Adresse des Slack-Servers, an den das Modul die Benachrichtigungen senden soll

Examplehttps://hooks.slack.com/services/...

OAuth Access Token((warning))

Das Token erhält man von Slack für seinen Workspace

Wird nur benötigt, wenn die Zwei-Wege Integration aktiviert ist

Enable Two-Way Integration

Über die Zwei-Wege Integration ist es Slack möglich Acknowledgements für Host und Services an openITCOCKPIT zu senden

Für diese Option ist es erforderlich, dass der openITCOCKPIT Server über das Internet erreichbar ist

Request URL

Wird von openITCOCKPIT generiert und gibt die Webhook URL für Slack an

Zuerst muss ein benutzerdefinierter API-Key mit openITCOCKPIT erstellt werden

Use Proxy Server
Gibt an, ob der konfigurierte Proxy verwendet werden soll


Einrichtung

openITCOCKPIT kommuniziert mit Slack über die Slack WebAPI und sendet als App Nachrichten in einen bestimmten Channel.

Gehe zum Erstellen der App auf die Webseite https://api.slack.com/apps?new_app=1

Bestimme einen eigenen App Name und wähle deinen eigenen Slack Workspace aus.

Wähle im linken Menü "Incoming Webhooks", aktiviere die Option oben rechts und füge deinem Workspace den Webhook mit Klick auf den unten stehenden Button hinzu.

Wähle einen Channel, in welchen die Nachrichten von openITCOCKPIT gepostet werden sollen.

Kopiere die eben erstellte Webhook URL und füge diese im openITCOCKPIT -> Administration -> Slack ein.


Zwei-Wege-Integration

Um Acknowledgements für Hosts und Services im Slack durchführen zu können, aktiviere die "Two-Way Integration".

openITCOCKPIT muss in diesem Fall von extern erreichbar sein.

Gehe dazu auf der Webseite der Slack API links im Menü auf "OAuth & Permissions", füge unten auf der Seite das Recht "users:read" hinzu und speichere die Änderungen.

Gegebenfalls muss der Webhook neu installiert werden. Folge dazu den Anweisungen am oberen Rand der Slack API Webseite.

Ist dies der Fall, muss ebenfalls die neue Webhook URL im openITCOCKPIT aktualisiert werden.

Kopiere danach das generierte OAuth Access Token und füge es im openITCOCKPIT ein.

Um die "Two-Way-Integration" zu aktivieren sollten die Slack Einstellungen wie folgt aussehen.

Optional kann die ausgehende Verbindung über den eingestellten Proxy aufgebaut werden.

Speichere deine Einstellungen und kopiere im nächsten Schritt die "Request URL".

Aktiviere "Interactive Messages" und füge die zuvor kopierte "Request URL" ein.


Aktiviere Slack Benachrichtigung

Füge deinem Kontakt, die bei der Modulinstallation automatisch erstellten Kommandos hinzu, oder ersetze die Alten.

Danach speichern und exportieren.


Kommandos

Für die Benachrichtigung müssen die folgendes Kommandos genutzt werden.


Host:

Host Notification Command - openITCOCKPIT Version 3.7
/usr/share/openitcockpit/app/Console/cake SlackModule.slack_notification --type Host --notificationtype $NOTIFICATIONTYPE$ --hostname "$HOSTNAME$" --hostaddress "$HOSTADDRESS$" --hoststate "$HOSTSTATEID$" --output "$HOSTOUTPUT$"
Host Notification Command - openITCOCKPIT Version 4.0
/usr/share/openitcockpit/app/cake4/bin/cake SlackModule.SlackNotification --type Host --notificationtype $NOTIFICATIONTYPE$ --hostname "$HOSTNAME$" --hostaddress "$HOSTADDRESS$" --hoststate "$HOSTSTATEID$" --output "$HOSTOUTPUT$"


Service:

Service Notification Command - openITCOCKPIT Version 3.7
/usr/share/openitcockpit/app/Console/cake SlackModule.slack_notification --type Service --notificationtype $NOTIFICATIONTYPE$ --hostname "$HOSTNAME$" --hostaddress "$HOSTADDRESS$" --hoststate "$HOSTSTATEID$" --servicedesc "$SERVICEDESC$" --servicestate "$SERVICESTATEID$" --output "$SERVICEOUTPUT$"
Service Notification Command - openITCOCKPIT Version 4.0
/usr/share/openitcockpit/app/cake4/bin/cake SlackModule.SlackNotification --type Service --notificationtype $NOTIFICATIONTYPE$ --hostname "$HOSTNAME$" --hostaddress "$HOSTADDRESS$" --hoststate "$HOSTSTATEID$" --servicedesc "$SERVICEDESC$" --servicestate "$SERVICESTATEID$" --output "$SERVICEOUTPUT$"
  • No labels