Changeset

4622:61ce3394fe8b

mod_pubsub_alertmanager: Add a README with initial docs
author Kim Alvefur <zash@zash.se>
date Fri, 16 Jul 2021 17:21:07 +0200
parents 4621:ebc2c099a11b
children 4623:622c6308d7af
files mod_pubsub_alertmanager/README.md
diffstat 1 files changed, 51 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_pubsub_alertmanager/README.md	Fri Jul 16 17:21:07 2021 +0200
@@ -0,0 +1,51 @@
+---
+labels:
+- 'Stage-Alpha'
+summary: Alertmanager webhook receiver for pubsub
+---
+
+# Introduction
+
+This module lets
+[Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/)
+publish alerts to [pubsub][doc:pubsub] via
+[webhooks](https://prometheus.io/docs/alerting/latest/configuration/#webhook_config).
+
+# Setup
+
+The relevant pubsub nodes must be created and configured somehow.
+Because the request IP address is used to publish, the `publisher`
+affiliation should be given to the IP address Alertmanager sends
+webhooks from.
+
+# Configuration
+
+On the Prosody side, apart from creating and configuring the node(s)
+that will be used, configure your pubsub service like this:
+
+``` lua
+Component "pubsub.example.com" "pubsub"
+modules_enabled = {
+    "pubsub_alertmanager",
+}
+
+-- optional extra settings:
+alertmanager_body_template = [[
+*ALARM!* {annotations.title?Alert} is {status}
+Since {startsAt}{endsAt& until {endsAt}}
+Labels: {labels%
+  {idx}: {item}}
+Annotations: {annotations%
+  {idx}: {item}}
+]]
+
+alertmanager_node_template = "alerts/{alert.labels.severity}"
+```
+
+Available configuration options:
+
+`alertmanager_body_template`
+:   Template for the textual representation of alerts.
+
+`alertmanager_node_template`
+:   Template for the pubsub node name, defaults to `"{path?alerts}"`