Correct instructions on Slack webhooks (#6016)
Chris Akritidis committed
May 15, 2019 at 10:51 UTC
288787a54c041b9fcaa81be0fa9dabe079fae5fe
2 files changed
+7
-16
health/notifications/health_alarm_notify.conf
+4
-4
@@ -363,10 +363,10 @@ DEFAULT_RECIPIENT_TELEGRAM=""
363
# enable/disable sending slack notifications
364
SEND_SLACK="YES"
365
366
-# Login to slack.com and create an incoming webhook. You need only one for all
367
-# your netdata servers (or you can have one for each of your netdata).
368
-# Without it, netdata cannot send slack notifications.
369
-# Get yours from: https://api.slack.com/incoming-webhooks
366
+# Login to your slack.com workspace and create an incoming webhook, using the "Incoming Webhooks" App: https://slack.com/apps/A0F7XDUAZ-incoming-webhooks
367
+# Do not use the instructions in https://api.slack.com/incoming-webhooks#enable_webhooks, as those webhooks work only for a single channel.
368
+# You need only one for all your netdata servers (or you can have one for each of your netdata).
369
+# Without the app and a webhook, netdata cannot send slack notifications.
370
SLACK_WEBHOOK_URL=""
371
372
# if a role's recipients are not configured, a notification will be send to:
health/notifications/slack/README.md
+3
-12
@@ -8,23 +8,14 @@ You need:
8
1. The **incoming webhook URL** as given by slack.com. You can use the same on all your netdata servers (or you can have multiple if you like - your decision).
9
2. One or more channels to post the messages to.
10
11
-Get them here: https://api.slack.com/incoming-webhooks
11
+To get a webhook that works on multiple channels, you will need to login to your slack.com workspace and create an incoming webhook using the [Incoming Webhooks App](https://slack.com/apps/A0F7XDUAZ-incoming-webhooks).
12
+Do NOT use the instructions in https://api.slack.com/incoming-webhooks#enable_webhooks, as the particular webhooks work only for a single channel.
13
13
-Set them in `/etc/netdata/health_alarm_notify.conf` (to edit it on your system run `/etc/netdata/edit-config health_alarm_notify.conf`), like this:
14
+Set the webhook and the recipients in `/etc/netdata/health_alarm_notify.conf` (to edit it on your system run `/etc/netdata/edit-config health_alarm_notify.conf`), like this:
15
16
```
16
-###############################################################################
17
-# sending slack notifications
18
-
19
-# note: multiple recipients can be given like this:
20
-# "RECIPIENT1 RECIPIENT2 ..."
21
-
22
-# enable/disable sending pushover notifications
17
SEND_SLACK="YES"
18
25
-# Login to slack.com and create an incoming webhook.
26
-# You need only one for all your netdata servers.
27
-# Without it, netdata cannot send slack notifications.
19
SLACK_WEBHOOK_URL="https://hooks.slack.com/services/XXXXXXXX/XXXXXXXX/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
20
21
# if a role's recipients are not configured, a notification will be send to: