Graylog SMS notifications – integration manual

Here we describe how to use SMSEagle Hardware SMS Gateway for Graylog SMS notifications and alerts.

Setup is easy and should take 5min to complete. No connection or maintenance to 3rd party systems is required. All notifications are generated on-premise and sent directly to 3G/4G cellular network. This solution can be used in secure installations without Internet access.

See also a short integration tutorial available in Graylog community portal.

 

SMSEagle Setup

  • Create a new user in SMSEagle.
  • Grant API access to the created user.
  • Enable API Access token. Generate new token.

 

Graylog Setup

1. Installation
Download the plugin and place the .jar file in your Graylog plugin directory. The default plugin directory is the plugins/ folder relative from your graylog-server directory and can be configured in your graylog.conf file.

Restart graylog-server and you are done.

2. Configuration
a) Go to menu Alerts > Notifications
b) Create new Notification

  • enter notification Title
  • select Notification Type: Legacy Alarm Callbacks
  • select Choose Legacy Notification: Legacy SMSEagle AlarmCallback
  • enter parameter URL of SMSEagle: URL to your SMSEagle device (for example: https://mysmsdevice.example.com or http://10.10.0.105)
  • enter Access Token: SMSEagle API access token created in point above
  • enter Recipient Phone Number: recipient telephone number (or numbers separated with comma)
  • alternatively, you may enter Group Name: group name defined in SMSEagle Phonebook (remember to set the group as Public in SMSEagle)
  • Press button Create to save the configuration

3. Test

To test the notification just use the button Execute Test Notification in the configuration window.