Home / Integration plugins / Centreon SMS Integration

+

Send SMS/voice alerts from Centreon

A host going down. A threshold breach. A failed check. Any of these can happen at 3 a.m., and someone needs to know. SMSEagle connects to Centreon and turns these events into an SMS or a voice call, delivered from your own hardware: no internet required, no third party involved.

A ready script to download

You download the script from the SMSEagle repository on GitHub and copy it to the Centreon server, with no code of your own to write.

You know what stopped working

Separate notifications for servers and services mean the SMS tells you straight away where the problem is.

A phone call for the most urgent alerts

For the most important alerts, SMSEagle can call instead of sending an SMS: a ring-only call or a call that reads the alert aloud.

How it works

1

Event Trigger

Centreon detects a host or service state change.

2

Communication

Centreon sends an HTTP API request directly to SMSEagle over your local network.

3

Alert

SMSEagle delivers the alert over its own cellular connection, not through a third-party service, as an SMS or a voice call to the contact’s phone.

Set up in about 5 minutes

It should take about five minutes to have it up and running. Generate an API token in SMSEagle, define the notification commands in Centreon, and you’re done.

SMSEagle sends Centreon alerts to the right person by SMS, phone call or WhatsApp, day and night.

SMS and voice calls from one device

SMSEagle sends Centreon alerts as an SMS, a ring-only call or a call that reads the alert aloud, all from a single device.

Fill-in-the-call-33

If the first person doesn't respond, the alert is sent to the next

Escalation groups and shift schedules make sure the Centreon alert reaches the person on duty, and the next person on the list if nobody responds.

Alerts keep working even if one device fails

Two SMSEagle devices can work as an HA cluster: if one fails, the other takes over sending.

SMSEagle configuration

  1. Create a new user for this script in the SMSEagle web interface: menu System > Users.
  2. Create an API key for that user:
    • go to Settings > Global settings > API and open the API v1 page
    • click Create API key, fill in Key name and select the user created above as Owner
    • Add access permissions in section Permissions for: Send SMS, Send to contact, Send to group (and optionally Ring call, Text-to-speech call, Advanced text-to-speech call)
    • click Create key
      The access token is shown only once, right after saving. The API token will be referenced below as SMSEAGLEAPITOKEN. Replace SMSEAGLEAPITOKEN in script below with your value

Centreon configuration

1. Download latest version of the script notify_eagle_sms.pl from our repository: https://github.com/smseagle/smseagle-nagios
Place the plugin in your Centreon plugins directory – usually /usr/lib/centreon/plugins/

2. Create the SMS notification commands.

Go to: Configuration -> Commands -> Notifications.

Press Add new button.
Before you paste the code, please remember to:

  • replace SMSEAGLEURL with URL Address of your SMSEagle device (for example: http://192.168.50.150)
  • replace SMSEAGLEAPITOKEN with your API token for your SMSEagle (for example: NZg2yNmWYb5Q7I3Y3Ifnk5E)

Create first command: service-notify-by-sms

$CENTREONPLUGINS$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -d $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $SERVICESTATE$ $SERVICEDESC$ Host($HOSTNAME$) Info($SERVICEOUTPUT$) Date($SHORTDATETIME$)"

Create second command: host-notify-by-sms

$CENTREONPLUGINS$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -d $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $HOSTSTATE$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)"
Optionally, create commands for Calls:
  • notify-by-ring-call
  • $CENTREONPLUGINS$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -c ring -d $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $SERVICESTATE$ $SERVICEDESC$ Host($HOSTNAME$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)"
  • host-notify-by-ring-call
    $CENTREONPLUGINS$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -c ring -d $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $HOSTSTATE$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)"
  • notify-by-tts-call
    $CENTREONPLUGINS$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -c tts -d $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $SERVICESTATE$ $SERVICEDESC$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)"
  • host-notify-by-tts-call
    $CENTREONPLUGINS$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -c tts -d $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $HOSTSTATE$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)"
  • notify-by-tts-adv-call
    $CENTREONPLUGINS$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -c tts_adv -d $CONTACTPAGER$ -voiceid SMSEAGLEVOICE -t "$NOTIFICATIONTYPE$ $SERVICESTATE$ $SERVICEDESC$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)"
  • host-notify-by-tts-adv-call
    $CENTREONPLUGINS$/notify_eagle_sms.pl -s SMSEAGLEURL -a SMSEAGLEAPITOKEN -c tts_adv -d $CONTACTPAGER$ -voiceid SMSEAGLEVOICE -t "$NOTIFICATIONTYPE$ $HOSTSTATE$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)"

3. Remember to add newly created notification commands to desired contacts. You can do that via: Configuration > Users > Contacts / Users

SMSEagle as SMTP Server (optional)

You can use the SMTP server installed on the SMSEagle device to send emails. In this scenario, emails from Centreon are sent directly to SMSEagle, without any external mail server. The SMTP server on the SMSEagle device accepts only messages addressed to it. Other messages are rejected.

Explore SMSEagle Demo device

SMSEagle is a hardware & software solution that guarantees a swift delivery of your messages to designated recipients, whether it’s for notifications, alerts, or important updates.

After registering to a demo you get a remote access to our physical device NXS-9750.

  • 14-days free trial
  • Access to over 20 functionalities

What is hardware
SMS Gateway?

Learn more about
SMSEagle features