PRTG Network Monitor – SendQuick Integration Guide

PRTG Network Monitor – SendQuick Integration Guide

Download Integration Guide
Contents

1. Introduction

This document is a guide on how to integrate SendQuick with PRTG Network Monitor to send SMS alerts. In this guide, we will be using SendQuick Entera Version 20220809- 4HF1 and PRTG 24.1.92.1 for the integration illustration.

There are three ways to send alert messages from PRTG Network Monitor to SendQuick systems. You can use any of the following methods

  • SMTP Delivery (email method)
  • SMS Delivery (http method) ‌
  • SNMP Trap

2.0 Send Email to SendQuick (SMTP Delivery)

When any sensor is down or there is a need to send a notification alert, PRTG can trigger an email to SendQuick. SendQuick will then convert the email message to SMS. For this setup, SendQuick has a built-in SMTP that PRTG can use as the SMTP Relay server.

2.1 Configure SMTP Delivery on PRTG Network Monitor

On the dashboard of PRTG Network Monitor, navigate to Setup > System Administration > Notification Delivery.

Figure 2-1: Notification Delivery

In the SMTP Delivery section, key in your own SendQuick IP address (e.g. 192.168.1.222) in SMTP Relay Server field as shown in the screenshot below:

Figure 2-2: SMTP Delivery – SMTP Relay Server

Ensure that you selected “Use SMTP relay server (recommended in LANs/NATs)“ as the SMTP Delivery Mechanism.

Fill in the Sender Email Address and Sender Name that you want to appear as the Sender information when notification messages are sent. Fill in the field for HELO Ident with a unique name, typically the name of the machine running PRTG.

For the SMTP Relay Server field, input the IP address of your SendQuick system. By default, the SMTP Relay SMTP Port is 25. Select “No authentication is required” for SMTP Relay Authentication.

Figure 2-3: SMTP Delivery Configuration

Quick tip – To check what you installed on SendQuick, navigate to the following:

Item on the SendQuick Dashboard:

Security Setup > SSL Setup > SSL Protocol

After the configuration, click on the Test SMTP Settings and test sending an email to see if the setup is correct.

To test if it can send SMS to your phone, use the following format for the Email Address: <mobilenumber>@<sendquickip>. See example below:

Figure 2-4: Test SMTP Delivery Settings
2.2 Configure Notification Templates

Next, configure the notification templates that can be used by notification triggers. In the PRTG Network Monitor dashboard, navigate to Setup > Account Settings > Notification Templates.

Figure 2-5: Notification Templates
Figure 2-5: Notification Templates

Create a new Notification Template by clicking on the Add Notification Template on the right of the screen and the Add Notification Template form will appear.

Give a meaningful name for e.g. “Send to SMTP” for the Template Name and ensure Status is “Started” for notifications to be active.

Figure 2-7: Notification Template Configuration

Scroll down and activate the Send Email option as shown below.

To specify the mobile number to receive the notification SMS, in the field Send to Email Address, use the following format <mobilenumber>@<sendquickip>.

Replace <mobilenumber> with the phone number and <sendquickip> with the IP address of your own SendQuick system. To send notification to more than one phone, you can add more email addresses using the same syntax, separated by commas.

If the messages are meant to be converted to SMS, use “Text” for the Format. See example below:

Figure 2-8: Setting Receiver Email Address
To test if the configuration is correctly setup, click on the test imageicon on the same row as the template name (in this example “Send to SMTP”).
Figure 2-9: Send SMTP Alert

A confirmation will popup if the Test email was sent successfully from PRTG to SendQuick.

Figure 2-10: SMTP Alert Test Result

To confirm that SendQuick has subsequently received the email and sent out as SMS, go to SendQuick dashboard. Navigate to Usage Logs > Message Logs

Click on the Sent tab and SMS tab. If there is a corresponding entry in the logs, that means the SMS text was sent successfully.

Figure 2-11: Successful SMTP Alert Log

Quicktip – SendQuick allows you to configure alerts to be sent to multiple phone numbers, groups or even combination of emails and sms. To explore this feature, navigate on the SendQuick dashboard to Filter Rules > Email Filter

You can create a new record to define the email address PRTG should send to. In our example, we use prtgalert@entera2022.sendquick.com

The user email can be anything meaningful that you choose but the domain name of the email address must correspond to your domain name of your SendQuick system.

Click on View for the record that you have created: 

Then click on Add New Record

You can then add multiple numbers, emails, or even pre-defined groups to receive the notification alerts.

After you have keyed in the information, click on Save to continue.

2.3 Configuring Notification Triggers

Once you have the Notification Templates configured, you can now reference them in the Notification Triggers. On the dashboard of PRTG Network Monitor, navigate to Devices > Notification Triggers.

Figure 2-12: Notification Triggers

Depending on the type of triggers you require, you can select the triggers to add. For this example, we will Add State Trigger.

Figure 2-13: Add State Trigger

You can define the parameters to activate the notifications. For the perform field,

choose the Notification Templates created earlier (e.g. Send to SMTP)

Figure 2-11: Successful SMTP Alert Log

3.0 Send SMS Message via HTTP Method

Similarly, notification alerts can be sent to SendQuick from PRTG via HTTP method. You do not need to do any configuration in SendQuick.

3.1 Configure SMS Delivery on PRTG Network Monitor

On the dashboard of PRTG Network Monitor, navigate to Setup > System Administration > Notification Delivery.

Figure 3-1: Notification Delivery Settings

Scroll down to the SMS Delivery section. For Configuration Mode, select “Enter a custom URL for a provider not listed.” Fill the Custom URL field with the SendQuick http URL string as follows:

http://<SendQuickIP>/cmd/system/api/sendsms.cgi?tar_num=%SMSNUMBER&tar_ msg=%SMSTEXT

Replace <SendQuickIP> with the IP address of your own SendQuick system. See the example :

Figure 3-2: SMS Delivery – Custom URL

After the configuration, you can do a test to see if it works. Click on Test SMS Settings.

Enter the phone Number to receive the SMS and the Message to be sent.

Figure 3-3: Test SMS Delivery Configuration

A popup will appear to indicate Test SMS Notification has been sent.

Figure 3-4: Test SMS Notification

To confirm that SendQuick has subsequently sent out the SMS text, on the SendQuick dashboard, navigate to Usage Logs > Message Logs.

Click on the Sent tab and SMS tab. If there is a corresponding entry in the logs, that means the SMS text was sent successfully.

Figure 3-5: Sent SMS Log

3.2 Configure Notification Templates

Next, configure the notification templates that can be used by notification triggers. In the PRTG Network Monitor dashboard, navigate to Setup > Account Settings > Notification Templates.

Figure 3-6: Notification Template Settings

Create a new Notification Template by clicking on the Add Notification Template on the right of the screen and the Add Notification Template form will appear.

Figure 3-7: Add Notification Template

Give a meaningful name (e.g. “Send to SMS”) for the Template Name and ensure

Status is “Started” for notifications to be active.

Figure 3-8: Send to SMS Notification Template Configurations – Basic Settings

Scroll down and activate the Send SMS option as shown below. Enter the number to receive the SMS in the field Send to Number

See example below:

Figure 3-9: Send SMS – Send to Phone Number
To test if the configuration is correctly setup, click on the test imageicon on the same row as the template name (in this example “Send to SMS”).
Figure 3-10: SMTP Alert Trigger

A confirmation will popup if the Test SMS was sent successfully from PRTG to SendQuick.

Figure 3-11: Test Result Confirmation

To confirm that SendQuick has subsequently received the message and sent out as SMS, go to SendQuick dashboard. Navigate to Usage Logs > Message Logs.

Click on the Sent tab and SMS tab. If there is a corresponding entry in the logs, that means the SMS text was sent successfully.

Figure 3-12: Alert Logged in Message Logs

3.3 Configuring Notification Triggers

Once you have the Notification Templates configured, you can now reference them in the Notification Triggers. On the dashboard of PRTG Network Monitor, navigate to Devices > Notification Triggers.

Figure 3-13: Notification Trigger Settings

Depending on the type of triggers you require, you can select the triggers to add. For this example, we will Add State Trigger.

Figure 3-14: Add State Trigger

You can define the parameters to activate the notifications. For the perform field, choose the Notification Templates created earlier (e.g. Send to SMS)

Figure 3-15: State Trigger Configuration

4.0 Send SNMP Trap to SendQuick

PRTG Network Monitor can also send alerts to SendQuick via SNMP trap. In SendQuick, we create a rule under SNMP Trap filter. On PRTG Network Monitor, create a corresponding Notification Template to match this filter. Once matched, SendQuick can receive the notification via SNMP trap and subsequently sent it out as SMS.

4.1 Configure SendQuick SNMP Trap Filter

Configure the SNMP trap filter on SendQuick. At the SendQuick dashboard, navigate to Filter Rules > SNMP Trap Filter.

Click on Add New Record.

Figure 4-1: SNMP Trap Filter – Add New Record

Give the filter an appropriate name under Description. Click on the checkbox next to From and key in the IP address of the machine PRTG Network Monitor was installed on. Click Save to continue.

Figure 4-2: SNMP Filter Rule Configurations

Click on View for the record that you have created:

Figure 4-3: View SNMP Trap Filter

Add in the phone number to receive the alerts under Mobile Number to Receive Alert. this is the page to also add other phone numbers, emails or groups to receive the same notification alerts. Once completed, scroll to the bottom and click on Save.

Figure 4-4: Adding mobile number to receive alert

4.2 Configure Notification Templates

Next, configure the notification templates that can be used by notification triggers. In the PRTG Network Monitor dashboard, navigate to Setup > Account Settings > Notification Templates.

Figure 4-5: Notification Template Settings

Create a new Notification Template by clicking on the Add Notification Template

on the right of the screen and the Add Notification Template form will appear.

Figure 4-6: Add Notification Template

Give a meaningful name for e.g. “SNMP Trap” for the Template Name and ensure Status is “Started” for notifications to be active. Scroll down and activate the “Send SNMP Trap” option as shown below.

Figure 4-7: SNMP Trap Configuration
Enter the IP address of your SendQuick system under Host/IP. You can leave the SNMP Port as 162. For the Community String key in public. Click on Save to continue. To test if the configuration is correctly setup, click on the test image icon on the same row as the template name (in this example “SNMP Trap”).
Figure 4-8: Send SNMP Trap Alert

A confirmation will popup if the Test SMS was sent successfully from PRTG to SendQuick.

Figure 4-9: SNMP Trap Test Notification

To confirm that SendQuick has subsequently received the SNMP Trap and sent out as SMS, go to SendQuick dashboard. Navigate to Usage Logs > Message Logs.

Click on the Sent tab and SMS tab. If there is a corresponding entry in the logs, that means the SMS text was sent successfully.

Figure 4-10: Test alert logged in Message Log

4.3  Configuring Notification Triggers

Once you have the Notification Templates configured, you can now reference them in the Notification Triggers. On the dashboard of PRTG Network Monitor, navigate to the following item Devices > Notification Triggers.

Figure 4-11: Notification Trigger Settings

Depending on the type of triggers you require, you can select the triggers to add. For this example, we will Add State Trigger.

Figure 4-12: Add State Trigger

You can define the parameters to activate the notifications. For the perform field,

choose the Notification Templates created earlier (e.g. SNMP Trap)

If configured correctly, whenever there is a Notification Trigger detected by PRTG Network Monitor, it will send the SNMP Trap to SendQuick. SendQuick will then send out the SMS text.

To confirm if the SMS are being sent out successfully, at the SendQuick dashboard, navigate to Usage Logs > Message Logs.

Click on the Sent tab and SMS tab. If there is a corresponding entry in the logs, that means the SMS text was sent successfully.

Figure 4-13: Sent SMS Logs