Added icinga2 module

fleaz · Jan 31, 2019 · 4c2cfaf · 4c2cfaf
1 parent 194d161
commit 4c2cfaf
Show file tree

Hide file tree

Showing 7 changed files with 479 additions and 0 deletions.
diff --git a/Gopkg.lock b/Gopkg.lock
diff --git a/README.md b/README.md
@@ -86,3 +86,20 @@ This dictionary maps full project paths (groupname/projectname) to IRC-channels.
 Receives arbitrary messages as text via a HTTP `POST` request and forwards this message line by line to a channel.
 The channel can be specified by the `channel` query parameter, otherwise the `default_channel` from the config will
 be used.
+
+### Icinga2
+Receives webhooks from Icinga2. Add [icinga2-notifications-webhook] to your icinga2 installation to send the
+required webhooks.
+
+When a webhook is received this module will first check if there is an explicit
+mapping in the configuration especially for this host. If yes, this channel will be used. If not, the module will
+look if there exists for the hostgroup. If yes, this channel will be used. If not, the `default` channel will be used.
+
+**Module specific configuration**
+```
+- hostgroups
+This dictionary maps Icinga2 hostgroups to IRC-channels.
+- explicit
+This dictionary maps hostnames to IRC-channels.
+```
+[icinga2-notifications-webhook]: https://git.s7t.de/ManiacTwister/icinga2-notifications-webhook
diff --git a/cpthook.yml.example b/cpthook.yml.example
@@ -36,4 +36,13 @@ modules:
     simple:
         enabled: True
         default_channel: "#defaultChannel"
+    icinga2:
+      enabled: True
+      default: "#monitoring"
+      hostgroups:
+          "webservers":
+              - "#monitoring-web"
+      explicit:
+          "host.example.tld":
+              - "#monitoring-example"