Votes:
I would like to use my SMSEagle Hardware SMS Gateway to send notifications from PRTG over it. How can I integrate SMSEagle with PRTG to use it for reliable SMS notifications when the internet connection fails? Is it possible to monitor the SMS gateway with PRTG?
Created on Jul 14, 2015 4:22:51 PM by
1 Reply
Votes:
This article applies as of PRTG Network Monitor 18
SMSEagle is a hardware SMS gateway that you can use to send text messages from PRTG independently from a working internet connection. You do not have to configure an executable notification but need only to provide an HTTP API call for this purpose. This makes SMSEagle a perfect add-on for PRTG to ensure SMS notification delivery from PRTG even if the main leased line is interrupted.
Setting up SMSEagle worked easily and fast in our labs. After connecting SMSEagle to your network, you can access its web interface with your browser and define all necessary settings. Provide the corresponding HTTP API call in the PRTG notification delivery settings and PRTG will send all your SMS notifications via this SMS gateway. See the steps below for detailed instructions.
Tip: We recommend that you always use a second notification type as a backup simultaneously to your primary notification method for critical errors. For example, if you use push notifications as your main notification type, which are usually reliable and fast, there can still be an outage of the internet connection or a failure or delay of the used cloud services. So you can set up SMS notifications as an alternative notification method and send these text notifications via an SMS gateway like SMSEagle. This way you ensure that you do not miss any alarms in your network because of a failing internet connection.
Note: This article is provided for your information only. We carefully tested the steps described here. However, we cannot offer technical support for the integration of third-party hardware. Please contact the vendor of SMSEagle if you encounter any issues.
Your SMSEagle package already comes with a quick start guide that explains the steps to connect the device to your network. Also have a look at the SMSEagle user manual for your SMSEagle product. Basically, you have to follow these steps:
If sending text messages directly from the SMSEagle device works, you can go on and prepare the SMS notification delivery settings in PRTG to send text messages over your hardware SMS gateway.
Define the SMS notification delivery in PRTG. Basically, this is providing the API call for the SMS hardware gateway.
http://<IP of SMSEagle>/index.php/http_api/prtg_sms?login=username&pass=password&to=%SMSNUMBER&message=%SMSTEXT
PRTG will now send all text message notifications you define via the SMSEagle SMS gateway.
The next step is to create a new SMS notification. If this notification is triggered by an alarm on a device, PRTG will use SMSEagle as defined in the SMS delivery settings to send the text message to the defined recipient.
The SMS notification is now ready to use. Select it when you create a notification trigger.
Check if you set up everything correctly for SMS delivery via SMSEagle:
Note: Test notifications contain unresolved placeholders.
Now add notification triggers to your devices in the PRTG web interface to use your new SMS notification via SMSEagle. Open the Notification Triggers tab on any monitoring object in your device tree and add the desired notification triggers, for example, a state trigger that will send an SMS if your device shows an error. For details, see PRTG Manual: Sensor Notification Triggers Settings.
SMSEagle comes with a built-in NET-SNMP agent that makes it possible to monitor various hardware parameters of the SMS gateway. This way you can ensure the hardware of your notification system works. So add a device to your PRTG installation that represents the SMSEagle hardware and include it into your monitoring.
You can use the PRTG Auto-Discovery mechanism to automatically create sensors that monitor, for example, uptime, traffic, memory, load, and active processes via SNMP, as well as the loading time of the web interface via HTTP. You can even monitor the SMSEagle database with the PostgreSQL sensor with the credentials given in the SMSEagle documentation.
Furthermore, the SMSEagle user manual provides OIDs for several SNMP metrics about your SMSEagle usage:
Look up the according OIDs in the SMSEagle documentation and create custom SNMP sensors in PRTG, for example, the SNMP Custom sensor to monitor one single SNMP metric from above, or the SNMP Custom Advanced sensor to monitor several or all SNMP metrics with one sensor.
You can also just download a device template for SMSEagle that creates the SNMP Custom Advanced sensor as in the screenshot:
Note: If the template above does not work, then you may have an older SMSEagle version. Please try the version below instead.
The SNMP Custom Advanced sensor in this template already includes all 6 custom OIDs for SMSEagle so you do not have to enter them manually when adding the sensor. Save the file SMSEagle.odt into the \devicetemplates subfolder of your PRTG program directory and run an auto-discovery on the SMSEagle device in PRTG using this template. You will get automatically the same channels as you can see in the screenshot above.
With SMSEagle you can also monitor if your PRTG server is available. If there is an outage of the server, SMSEagle can send you immediately an SMS to alert you about this major impact on your network monitoring. Provide the address of your PRTG server in section Network Monitor and add PRTG as a new task.
Created on Jul 14, 2015 4:56:19 PM by
Last change on Jan 9, 2023 7:37:39 AM by
Add comment