Home / Integration plugins / Graylog SMS Integration

+

Send SMS alerts from Graylog

Graylog alerts reach the person on duty as an SMS. SMSEagle sends them over its own cellular connection, so they don’t depend on internet access or a cloud service.

Ready plugin for Graylog

You install the SMSEagle Notification plugin in Graylog, with no code of your own to write.

SMS only when a condition is met

Graylog sends an SMS only when incoming logs match the alert condition you set.

Works without internet

SMSEagle sends alerts through its own SIM card straight to the mobile network, so they don’t depend on internet access or a cloud SMS provider.

How it works

1

Event Trigger

A Graylog alert matches a configured condition on incoming log data.

2

Communication

Graylog’s SMSEagle Notification plugin sends an HTTP API request to the SMSEagle device over your local network.

3

Alert

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

Set up in about 5 minutes

Setup is easy and should take about five minutes. Generate an API token in SMSEagle, install the SMSEagle Notification plugin in Graylog, and you’re done.

SMSEagle sends Graylog alerts to the right person by SMS, day and night.

No per-message fees

SMSEagle sends SMS through a regular SIM card, so you only pay for your mobile plan.

Alerts keep going if one carrier fails

On devices with two SIM cards from different operators, SMSEagle switches to the second one when the first operator’s network is down.

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

  • Create a new user in SMSEagle (menu System > Users, user access level: “User”).
  • Grant API access to the created user:
    • go to Settings > Global settings > API and open the API v2 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.
    • click Create key. The access token is shown only once, right after saving

Graylog configuration

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: SMSEagle Notification
  • Enter parameter SMSEagle URL: 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 the SMSEagle configuration section
  • Enter at least one type of recipient
  • Provide other required parameters for the message type of your choice
  • Press button Create to save the configuration

For more information about API parameters, please check the SMSEagle APIv2 documentation (https://www.smseagle.eu/docs/apiv2/)

3. Test

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

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