Icinga Push Notifications
Updated on August 31, 2026
Git Repository
Use Signalgrid as an Icinga mobile app
The Signalgrid Icinga integration forwards monitoring alerts to the Signalgrid push notification API. It maps monitoring states such as OK, WARNING, CRITICAL, and DOWN to the appropriate Signalgrid notification types.
This allows you to receive infrastructure alerts directly on your devices when hosts or services change state.
Prerequisites
- curl must be installed to send API requests
- The script must be executable by the icinga user
Installation
Bash
# Save the script to your server
/usr/local/bin/signalgrid-notify.sh
# Make the script executable
chmod +x /usr/local/bin/signalgrid-notify.sh
# Edit the script and insert your credentials
CLIENT_KEY="[your-client-key]"
CHANNEL_TOKEN="[your-channel-token]"
Script Arguments
The script accepts four positional arguments:
Argument
Description
$1Title of the notification
$2Message body or plugin output
$3State:
OK, UP, WARNING, CRITICAL, or DOWN$4Critical flag:
true or falseDefine the NotificationCommand
Create a notification command in your Icinga configuration:
Icinga 2
object NotificationCommand "signalgrid-notify" {
command = [ "/usr/local/bin/signalgrid-notify.sh" ]
arguments = {
0 = {
value = service ?
service.name + " on " + host.name + " is " + service.state :
"Host " + host.name + " is " + host.state
}
1 = {
value = service ? service.output : host.output
}
2 = {
value = service ? service.state : host.state
}
3 = {
value = (service && service.state == "Critical") ||
(!service && host.state == "Down") ?
"true" : "false"
}
}
}
Apply Service Notifications
Icinga 2
apply Notification "signalgrid-service" to Service {
command = "signalgrid-notify"
states = [ OK, Warning, Critical, Unknown ]
types = [ Problem, Recovery ]
users = [ "icingaadmin" ]
assign where host.vars.enable_signalgrid == true
}
Apply Host Notifications
Icinga 2
apply Notification "signalgrid-host" to Host {
command = "signalgrid-notify"
states = [ Up, Down ]
types = [ Problem, Recovery ]
users = [ "icingaadmin" ]
assign where host.vars.enable_signalgrid == true
}
Enable Signalgrid for a Host
Icinga 2
object Host "my-server" {
import "generic-host"
address = "192.168.1.10"
vars.enable_signalgrid = true
}
Manual Testing
You can verify the integration directly from the command line:
Bash
/usr/local/bin/signalgrid-notify.sh \
"Test Alert" \
"Manual test from terminal" \
"CRITICAL" \
"false"