Creating own repository for this one
This commit is contained in:
Marianne M. Spiller
parent
71ab40c040
commit
d35cdf14d4
5 changed files with 370 additions and 2 deletions
136
README.md
136
README.md
|
|
@ -1,2 +1,134 @@
|
|||
# icinga2-notification-telegram
|
||||
Send Icinga 2 notifications via Telegram
|
||||
### Notification by Telegram
|
||||
Send Icinga 2 notification via Telegram
|
||||
|
||||
|
||||
|
||||
Example Notification Object
|
||||
---------------------------
|
||||
|
||||
```ini
|
||||
apply Notification "Host by Telegram" to Host {
|
||||
command = "Notify Host By Telegram"
|
||||
interval = 1h
|
||||
assign where host.vars.notification_type == "Telegram"
|
||||
users = [ "telegram_unixe" ]
|
||||
vars.notification_logtosyslog = true
|
||||
vars.telegram_bot = "<YOUR_TELEGRAM_BOT_NAME>"
|
||||
vars.telegram_botid = "<YOUR_TELEGRAM_BOT_ID>"
|
||||
vars.telegram_bottoken = "<YOUR_TELEGRAM_BOT_TOKEN>"
|
||||
}
|
||||
```
|
||||
|
||||
Command Definitions
|
||||
-------------------
|
||||
```ini
|
||||
object NotificationCommand "Notify Host By Telegram" {
|
||||
import "plugin-notification-command"
|
||||
command = [ "/etc/icinga2/scripts/host-by-telegram.sh" ]
|
||||
arguments += {
|
||||
"-4" = {
|
||||
required = true
|
||||
value = "$address$"
|
||||
}
|
||||
"-6" = "$address6$"
|
||||
"-b" = "$notification.author$"
|
||||
"-c" = "$notification.comment$"
|
||||
"-d" = {
|
||||
required = true
|
||||
value = "$icinga.long_date_time$"
|
||||
}
|
||||
"-i" = "$icingaweb2url$"
|
||||
"-l" = {
|
||||
required = true
|
||||
value = "$host.name$"
|
||||
}
|
||||
"-n" = "$host.display_name$"
|
||||
"-o" = {
|
||||
required = true
|
||||
value = "$host.output$"
|
||||
}
|
||||
"-p" = {
|
||||
required = true
|
||||
value = "$telegram_bot$"
|
||||
}
|
||||
"-q" = {
|
||||
required = true
|
||||
value = "$telegram_botid$"
|
||||
}
|
||||
"-r" = {
|
||||
required = true
|
||||
value = "$telegram_bottoken$"
|
||||
}
|
||||
"-s" = {
|
||||
required = true
|
||||
value = "$host.state$"
|
||||
}
|
||||
"-t" = {
|
||||
required = true
|
||||
value = "$notification.type$"
|
||||
}
|
||||
"-v" = "$notification_logtosyslog$"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
```ini
|
||||
object NotificationCommand "Notify Service By Telegram" {
|
||||
import "plugin-notification-command"
|
||||
command = [ "/etc/icinga2/scripts/service-by-telegram.sh" ]
|
||||
arguments += {
|
||||
"-4" = {
|
||||
required = true
|
||||
value = "$address$"
|
||||
}
|
||||
"-6" = "$address6$"
|
||||
"-b" = "$notification.author$"
|
||||
"-c" = "$notification.comment$"
|
||||
"-d" = {
|
||||
required = true
|
||||
value = "$icinga.long_date_time$"
|
||||
}
|
||||
"-e" = {
|
||||
required = true
|
||||
value = "$service.name$"
|
||||
}
|
||||
"-i" = "$icingaweb2url$"
|
||||
"-l" = {
|
||||
required = true
|
||||
value = "$host.name$"
|
||||
}
|
||||
"-n" = "$host.display_name$"
|
||||
"-o" = {
|
||||
required = true
|
||||
value = "$service.output$"
|
||||
}
|
||||
"-p" = {
|
||||
required = true
|
||||
value = "$telegram_bot$"
|
||||
}
|
||||
"-q" = {
|
||||
required = true
|
||||
value = "$telegram_botid$"
|
||||
}
|
||||
"-r" = {
|
||||
required = true
|
||||
value = "$telegram_bottoken$"
|
||||
}
|
||||
"-s" = {
|
||||
required = true
|
||||
value = "$service.state$"
|
||||
}
|
||||
"-t" = {
|
||||
required = true
|
||||
value = "$notification.type$"
|
||||
}
|
||||
"-u" = {
|
||||
required = true
|
||||
value = "$service.display_name$"
|
||||
}
|
||||
"-v" = "$notification_logtosyslog$"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
|
|
|
|||
117
host-by-telegram.sh
Executable file
117
host-by-telegram.sh
Executable file
|
|
@ -0,0 +1,117 @@
|
|||
#!/usr/bin/env bash
|
||||
## /etc/icinga2/scripts/host-by-telegram.sh / 20170330
|
||||
## Marianne M. Spiller <github@spiller.me>
|
||||
## Last updated 20170424
|
||||
## Tested icinga2-2.6.3-1
|
||||
|
||||
PROG="`basename $0`"
|
||||
HOSTNAME="`hostname`"
|
||||
TRANSPORT="curl"
|
||||
|
||||
if [ -z "`which $TRANSPORT`" ] ; then
|
||||
echo "$TRANSPORT not in \$PATH. Consider installing it."
|
||||
exit 1
|
||||
fi
|
||||
|
||||
Usage() {
|
||||
cat << EOF
|
||||
|
||||
host-by-mail notification script for Icinga 2 by spillerm <github@spiller.me>
|
||||
|
||||
The following are mandatory:
|
||||
-4 HOSTADDRESS (\$address$)
|
||||
-6 HOSTADDRESS6 (\$address6\)
|
||||
-d LONGDATETIME (\$icinga.long_date_time$)
|
||||
-l HOSTALIAS (\$host.name$)
|
||||
-n HOSTDISPLAYNAME (\$host.display_name$)
|
||||
-o HOSTOUTPUT (\$host.output$)
|
||||
-p TELEGRAM_BOT (\$telegram_bot$)
|
||||
-q TELEGRAM_BOTID (\$telegram_botid$)
|
||||
-r TELEGRAM_BOTTOKEN (\$telegram_bottoken$)
|
||||
-s HOSTSTATE (\$host.state$)
|
||||
-t NOTIFICATIONTYPE (\$notification.type$)
|
||||
|
||||
And these are optional:
|
||||
-b NOTIFICATIONAUTHORNAME (\$notification.author$)
|
||||
-c NOTIFICATIONCOMMENT (\$notification.comment$)
|
||||
-i HAS_ICINGAWEB2 (\$icingaweb2url$, Default: unset)
|
||||
-v (\$notification_logtosyslog$, Default: false)
|
||||
|
||||
EOF
|
||||
|
||||
exit 1;
|
||||
}
|
||||
|
||||
while getopts 4:6::b:c:d:hi:l:n:o:p:q:r:s:t:u:v: opt
|
||||
do
|
||||
case "$opt" in
|
||||
4) HOSTADDRESS=$OPTARG ;;
|
||||
6) HOSTADDRESS6=$OPTARG ;;
|
||||
b) NOTIFICATIONAUTHORNAME=$OPTARG ;;
|
||||
c) NOTIFICATIONCOMMENT=$OPTARG ;;
|
||||
d) LONGDATETIME=$OPTARG ;;
|
||||
h) Usage ;;
|
||||
i) HAS_ICINGAWEB2=$OPTARG ;;
|
||||
l) HOSTALIAS=$OPTARG ;;
|
||||
n) HOSTDISPLAYNAME=$OPTARG ;;
|
||||
o) HOSTOUTPUT=$OPTARG ;;
|
||||
p) TELEGRAM_BOT=$OPTARG ;;
|
||||
q) TELEGRAM_BOTID=$OPTARG ;;
|
||||
r) TELEGRAM_BOTTOKEN=$OPTARG ;;
|
||||
s) HOSTSTATE=$OPTARG ;;
|
||||
t) NOTIFICATIONTYPE=$OPTARG ;;
|
||||
v) VERBOSE=$OPTARG ;;
|
||||
\?) echo "ERROR: Invalid option -$OPTARG" >&2
|
||||
Usage ;;
|
||||
:) echo "Missing option argument for -$OPTARG" >&2
|
||||
Usage ;;
|
||||
*) echo "Unimplemented option: -$OPTARG" >&2
|
||||
Usage ;;
|
||||
esac
|
||||
done
|
||||
|
||||
## Build the message's subject
|
||||
SUBJECT="[$NOTIFICATIONTYPE] $SERVICEDISPLAYNAME on $HOSTDISPLAYNAME is $SERVICESTATE!"
|
||||
|
||||
## Build the message itself
|
||||
NOTIFICATION_MESSAGE=$(cat << EOF
|
||||
$HOSTDISPLAYNAME ($HOSTALIAS) is $HOSTSTATE!
|
||||
When? $LONGDATETIME
|
||||
Info? $HOSTOUTPUT
|
||||
Host? $HOSTALIAS
|
||||
IPv4? $HOSTADDRESS
|
||||
EOF
|
||||
)
|
||||
|
||||
## Is this host IPv6 capable?
|
||||
if [ -n "$HOSTADDRESS6" ] ; then
|
||||
NOTIFICATION_MESSAGE="$NOTIFICATION_MESSAGE
|
||||
IPv6? $HOSTADDRESS6"
|
||||
fi
|
||||
## Are there any comments? Put them into the message!
|
||||
if [ -n "$NOTIFICATIONCOMMENT" ] ; then
|
||||
NOTIFICATION_MESSAGE="$NOTIFICATION_MESSAGE
|
||||
Comment by $NOTIFICATIONAUTHORNAME:
|
||||
$NOTIFICATIONCOMMENT"
|
||||
fi
|
||||
## Are we using Icinga Web 2? Put the URL into the message!
|
||||
if [ -n "$HAS_ICINGAWEB2" ] ; then
|
||||
NOTIFICATION_MESSAGE="$NOTIFICATION_MESSAGE
|
||||
Get live status:
|
||||
$HAS_ICINGAWEB2/monitoring/host/show?host=$HOSTALIAS"
|
||||
fi
|
||||
## Build the message's subject
|
||||
SUBJECT="[$NOTIFICATIONTYPE] Host $HOSTDISPLAYNAME is $HOSTSTATE!"
|
||||
|
||||
## Are we verbose? Then put a message to syslog...
|
||||
if [ "$VERBOSE" == "true" ] ; then
|
||||
logger "$PROG sends $SUBJECT => Telegram Channel $TELEGRAM_BOT"
|
||||
fi
|
||||
|
||||
## And finally, send the message
|
||||
/usr/bin/curl --silent --output /dev/null \
|
||||
--data-urlencode "chat_id=${TELEGRAM_BOTID}" \
|
||||
--data-urlencode "text=${NOTIFICATION_MESSAGE}" \
|
||||
--data-urlencode "parse_mode=HTML" \
|
||||
--data-urlencode "disable_web_page_preview=true" \
|
||||
"https://api.telegram.org/bot${TELEGRAM_BOTTOKEN}/sendMessage"
|
||||
BIN
img/Telegram.png
Normal file
BIN
img/Telegram.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 184 KiB |
BIN
img/Telegram_Notification_in_Icinga_Director.jpg
Normal file
BIN
img/Telegram_Notification_in_Icinga_Director.jpg
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 75 KiB |
119
service-by-telegram.sh
Executable file
119
service-by-telegram.sh
Executable file
|
|
@ -0,0 +1,119 @@
|
|||
#!/usr/bin/env bash
|
||||
## /etc/icinga2/scripts/service-by-telegram.sh / 20170330
|
||||
## Marianne M. Spiller <github@spiller.me>
|
||||
## Last updated 20170424
|
||||
## Tested icinga2-2.6.3-1
|
||||
|
||||
PROG="`basename $0`"
|
||||
HOSTNAME="`hostname`"
|
||||
TRANSPORT="curl"
|
||||
|
||||
if [ -z "`which $TRANSPORT`" ] ; then
|
||||
echo "$TRANSPORT not in \$PATH. Consider installing it."
|
||||
exit 1
|
||||
fi
|
||||
|
||||
Usage() {
|
||||
cat << EOF
|
||||
|
||||
service-by-telegram notification script for Icinga 2 by spillerm <github@spiller.me>
|
||||
|
||||
The following are mandatory:
|
||||
-4 HOSTADDRESS (\$address$)
|
||||
-6 HOSTADDRESS6 (\$address6$)
|
||||
-d LONGDATETIME (\$icinga.long_date_time$)
|
||||
-e SERVICENAME (\$service.name$)
|
||||
-l HOSTALIAS (\$host.name$)
|
||||
-n HOSTDISPLAYNAME (\$host.display_name$)
|
||||
-o SERVICEOUTPUT (\$service.output$)
|
||||
-p TELEGRAM_BOT (\$telegram_bot$)
|
||||
-q TELEGRAM_BOTID (\$telegram_botid$)
|
||||
-r TELEGRAM_BOTTOKEN (\$telegram_bottoken$)
|
||||
-s SERVICESTATE (\$service.state$)
|
||||
-t NOTIFICATIONTYPE (\$notification.type$)
|
||||
-u SERVICEDISPLAYNAME (\$service.display_name$)
|
||||
|
||||
And these are optional:
|
||||
-b NOTIFICATIONAUTHORNAME (\$notification.author$)
|
||||
-c NOTIFICATIONCOMMENT (\$notification.comment$)
|
||||
-i HAS_ICINGAWEB2 (\$icingaweb2url$, Default: unset)
|
||||
-v (\$notification_logtosyslog$, Default: false)
|
||||
|
||||
EOF
|
||||
exit 1;
|
||||
}
|
||||
|
||||
while getopts 4:6:b:c:d:e:f:hi:l:n:o:p:q:r:s:t:u:v: opt
|
||||
do
|
||||
case "$opt" in
|
||||
4) HOSTADDRESS=$OPTARG ;;
|
||||
6) HOSTADDRESS6=$OPTARG ;;
|
||||
b) NOTIFICATIONAUTHORNAME=$OPTARG ;;
|
||||
c) NOTIFICATIONCOMMENT=$OPTARG ;;
|
||||
d) LONGDATETIME=$OPTARG ;;
|
||||
e) SERVICENAME=$OPTARG ;;
|
||||
h) Usage ;;
|
||||
i) HAS_ICINGAWEB2=$OPTARG ;;
|
||||
l) HOSTALIAS=$OPTARG ;;
|
||||
n) HOSTDISPLAYNAME=$OPTARG ;;
|
||||
o) SERVICEOUTPUT=$OPTARG ;;
|
||||
p) TELEGRAM_BOT=$OPTARG ;;
|
||||
q) TELEGRAM_BOTID=$OPTARG ;;
|
||||
r) TELEGRAM_BOTTOKEN=$OPTARG ;;
|
||||
s) SERVICESTATE=$OPTARG ;;
|
||||
t) NOTIFICATIONTYPE=$OPTARG ;;
|
||||
u) SERVICEDISPLAYNAME=$OPTARG ;;
|
||||
v) VERBOSE=$OPTARG ;;
|
||||
\?) echo "ERROR: Invalid option -$OPTARG" >&2
|
||||
Usage ;;
|
||||
:) echo "Missing option argument for -$OPTARG" >&2
|
||||
Usage ;;
|
||||
*) echo "Unimplemented option: -$OPTARG" >&2
|
||||
Usage ;;
|
||||
esac
|
||||
done
|
||||
|
||||
## Build the message's subject
|
||||
SUBJECT="[$NOTIFICATIONTYPE] $SERVICEDISPLAYNAME on $HOSTDISPLAYNAME is $SERVICESTATE!"
|
||||
|
||||
## Build the message itself
|
||||
NOTIFICATION_MESSAGE=$(cat << EOF
|
||||
[$SERVICESTATE] $SERVICEDISPLAYNAME is $SERVICESTATE since $LONGDATETIME
|
||||
Host: $HOSTALIAS (IPv4 $HOSTADDRESS)
|
||||
More info: $SERVICEOUTPUT
|
||||
EOF
|
||||
)
|
||||
|
||||
## Is this host IPv6 capable?
|
||||
if [ -n "$HOSTADDRESS6" ] ; then
|
||||
NOTIFICATION_MESSAGE="$NOTIFICATION_MESSAGE
|
||||
IPv6? $HOSTADDRESS6"
|
||||
fi
|
||||
|
||||
## Are there any comments? Put them into the message!
|
||||
if [ -n "$NOTIFICATIONCOMMENT" ] ; then
|
||||
NOTIFICATION_MESSAGE="$NOTIFICATION_MESSAGE
|
||||
|
||||
Comment by $NOTIFICATIONAUTHORNAME:
|
||||
$NOTIFICATIONCOMMENT"
|
||||
fi
|
||||
|
||||
## Are we using Icinga Web 2? Put the URL into the message!
|
||||
if [ -n "$HAS_ICINGAWEB2" ] ; then
|
||||
NOTIFICATION_MESSAGE="$NOTIFICATION_MESSAGE
|
||||
Get live status:
|
||||
$HAS_ICINGAWEB2/monitoring/host/show?host=$HOSTALIAS"
|
||||
fi
|
||||
|
||||
## Are we verbose? Then put a message to syslog...
|
||||
if [ "$VERBOSE" == "true" ] ; then
|
||||
logger "$PROG sends $SUBJECT => Telegram Channel $TELEGRAM_BOT"
|
||||
fi
|
||||
|
||||
## And finally, send the message
|
||||
/usr/bin/curl --silent --output /dev/null \
|
||||
--data-urlencode "chat_id=${TELEGRAM_BOTID}" \
|
||||
--data-urlencode "text=${NOTIFICATION_MESSAGE}" \
|
||||
--data-urlencode "parse_mode=HTML" \
|
||||
--data-urlencode "disable_web_page_preview=true" \
|
||||
"https://api.telegram.org/bot${TELEGRAM_BOTTOKEN}/sendMessage"
|
||||
Loading…
Reference in a new issue