Add telegram notifications to health monitoring

[netdata.git] / conf.d / health_alarm_notify.conf

diff --git a/conf.d/health_alarm_notify.conf b/conf.d/health_alarm_notify.conf
index bb3761e182191f28389bea00378b6d15252c4500..76359759ad61313f302dab820fd523bc5bf2c682 100644 (file)
--- a/conf.d/health_alarm_notify.conf
+++ b/conf.d/health_alarm_notify.conf
@@ -7,6 +7,7 @@
 # - e-mails,
 # - push notifications to your mobile phone,
 # - messages to your slack team
+# - messages to your telegram chat / group chat
 #
 # the recipient given in netdata alarms defines a role, so that different
 # people can be notified for each role.
@@ -33,7 +34,7 @@ sendmail=""
 
 # The full path of the curl command.
 # If empty, the system $PATH will be searched for it.
-# If not found, pushover and slack notifications will be disabled.
+# If not found, pushover, telegram and slack notifications will be disabled.
 curl=""
 
 
@@ -44,6 +45,7 @@ curl=""
 #
 #  - emails addresses
 #  - pushover user tokens
+#  - telegram chat ids
 #  - slack channels
 #
 # You can append |critical to limit the notifications to be sent.
@@ -52,10 +54,11 @@ curl=""
 # while the second one receives only the critical ones:
 #  email   : "user1@example.com user2@example.com|critical"
 #  pushover: "2987343...9437837 8756278...2362736|critical"
+#  telegram: "111827421 112746832|critical"
 #  slack   : "alarms disasters|critical"
 #
 # If a recipient is set to empty string, the default recipient of the given
-# notification method (email, pushover, slack) will be used.
+# notification method (email, pushover, telegram, slack) will be used.
 # To disable a notification, use the recipient called: disabled
 # This works for all notification methods (including the default recipients).
 
@@ -92,6 +95,26 @@ PUSHOVER_APP_TOKEN=""
 DEFAULT_RECIPIENT_PUSHOVER=""
 
 
+###############################################################################
+# sending telegram messages (telegram.org)
+
+# To get your chat ID send the command /my_id to telegram bot @get_id.
+# Users also need to open a query with the bot.
+
+# note: multiple recipients can be given like this:
+#                  "CHAT_ID_1 CHAT_ID_1 ..."
+
+# enable/disable sending telegram messages
+SEND_TELEGRAM="YES"
+
+# Contact the bot @BotFather to create a new bot and to receive a bot token.
+# Without it, netdata cannot send telegram messages.
+TELEGRAM_BOT_TOKEN=""
+
+# If a role's recipients are not configured, a message will be send to this chat id:
+DEFAULT_RECIPIENT_TELEGRAM=""
+
+
 ###############################################################################
 # sending slack notifications
 
@@ -123,6 +146,8 @@ role_recipients_email[sysadmin]="${DEFAULT_RECIPIENT_EMAIL}"
 
 role_recipients_pushover[sysadmin]="${DEFAULT_RECIPIENT_PUSHOVER}"
 
+role_recipients_telegram[sysadmin]="${DEFAULT_RECIPIENT_TELEGRAM}"
+
 role_recipients_slack[sysadmin]="${DEFAULT_RECIPIENT_SLACK}"
 
 
@@ -133,6 +158,8 @@ role_recipients_email[domainadmin]="${DEFAULT_RECIPIENT_EMAIL}"
 
 role_recipients_pushover[domainadmin]="${DEFAULT_RECIPIENT_PUSHOVER}"
 
+role_recipients_telegram[domainadmin]="${DEFAULT_RECIPIENT_TELEGRAM}"
+
 role_recipients_slack[domainadmin]="${DEFAULT_RECIPIENT_SLACK}"
 
 
@@ -144,6 +171,8 @@ role_recipients_email[dba]="${DEFAULT_RECIPIENT_EMAIL}"
 
 role_recipients_pushover[dba]="${DEFAULT_RECIPIENT_PUSHOVER}"
 
+role_recipients_telegram[dba]="${DEFAULT_RECIPIENT_TELEGRAM}"
+
 role_recipients_slack[dba]="${DEFAULT_RECIPIENT_SLACK}"
 
 
@@ -155,6 +184,8 @@ role_recipients_email[webmaster]="${DEFAULT_RECIPIENT_EMAIL}"
 
 role_recipients_pushover[webmaster]="${DEFAULT_RECIPIENT_PUSHOVER}"
 
+role_recipients_telegram[webmaster]="${DEFAULT_RECIPIENT_TELEGRAM}"
+
 role_recipients_slack[webmaster]="${DEFAULT_RECIPIENT_SLACK}"
 
 
@@ -166,4 +197,6 @@ role_recipients_email[proxyadmin]="${DEFAULT_RECIPIENT_EMAIL}"
 
 role_recipients_pushover[proxyadmin]="${DEFAULT_RECIPIENT_PUSHOVER}"
 
+role_recipients_telegram[proxyadmin]="${DEFAULT_RECIPIENT_TELEGRAM}"
+
 role_recipients_slack[proxyadmin]="${DEFAULT_RECIPIENT_SLACK}"