PRTG Manual: Notifications Based on Sensor Limits Step by Step
This documentation refers to an administrator that accesses the PRTG web interface on a master node. Other user accounts, interfaces, or failover nodes might not have all of the options in the way described here. In a cluster, note that failover nodes are read-only by default.
This section gives you an example of how to set up a notification for exceeded disk free limits. Take the following steps to set up notifications based on limits:
- Step 1: Provide necessary information about the delivery of notifications (Simple Mail Transfer Protocol (SMTP) and SMS).
- Step 2: Specify the recipients of notifications for each user account.
- Step 3: Specify the notification methods and content to create the actual notifications.
- Step 4: Define limits that change a sensor's status (this is not necessary for every kind of notification).
- Step 5: Add suitable triggers to objects that trigger notifications if there is an issue in your network.
- Step 6: Test if PRTG correctly triggers and delivers the created notifications.
Before you can create actual notifications, you have to define how PRTG delivers the notifications to your email account, mobile phone, or pager. To do so, select Setup | System Administration | Notification Delivery from the main menu bar. Specify the mechanism for SMTP delivery, the sender email address and name, as well as the HELO ident. For SMS delivery, select your service provider and enter the corresponding credentials.
For more information, see section Notification Delivery.
This only applies to PRTG on premises installations, not to PRTG Hosted Monitor instances.
Create notification contacts to define how you want to receive notifications. Recipients can be email addresses, phone numbers (only available for PRTG on premises), or push devices (Android or iOS devices with the corresponding PRTG app).
You can define as many recipients as you want for each user account. By default, the recipient Primary Email Address is available. This is the email address that you provide in your account settings.
For more information, see section Notification Contacts.
To get an informative message when a disk is running out of free space, create a corresponding notification:
- Select Setup | Account Settings | Notification Templates from the main menu bar.
- Hover over and click Add Notification Template.
- Enter a meaningful name for the notification template, for example, Disk Free Limit Notification.
If you want to trigger this notification on a global level, for example for a probe or group, so that it does not only apply to breached disk free limits, a general name might be more suitable (like the predefined notification Email to Admin, for example).
- You can optionally create a Schedule to activate notifications only at specific times, for example, only on weekdays. In section Notification Summarization, you can choose from various options to avoid message floods. Furthermore, you can define the User Group Access to this notification.
- Select a notification method. In this case, enable next to Send Email.
You can select any other notification method, of course. For more information, see section Notification Templates.
- Specify who receives a notification, for example, select a specific user and PRTG sends the notification to all notification contacts that you defined for this user account in step 2.
- Enter the Subject of the email notification or use the predefined placeholders.
For available placeholders, see section List of Placeholders for Notifications.
- Specify the Format and the Priority of the notification.
- Click Create. PRTG opens the Notifications Templates tab.
You can now use the new notification for every trigger on every object in your device tree.
Before you create triggers that initiate notifications, you need to specify the limits that you want to apply to your disks. For example, if you want to get a notification when a disk has exceeded 80% of its capacity, set the sensor to the Warning status if it reaches this limit. You have the following options to set limits for disk free sensors:
- Step 4.1: Set limits that are checked against all disks in the settings of multi-drive sensors such as the WMI Free Disk Space (Multi Disk) sensor, the SNMP Linux Disk Free sensor, or the SSH Disk Free sensor.
- Step 4.2: Enable limits in the channel settings of single sensors.
You can also use the multi-edit functionality to set limits for multiple sensors at once.
You can set limits for sensors that monitor multiple disks directly via the sensor's Settings tab. Multi-edit for sensors is also possible.
- Open the settings of the selected sensor and go to section Set Limits Checked For ALL Disks.
- Enable Use the limits of both the sensor and the channel settings.
- In the field Lower Warning Limit, enter the percentage that suits your needs. In our example, this is 20. This limit applies to all channels of the selected sensors that represent disks.
Alternatively, you can use bytes to define a limit. However, we recommend that you use percentage values for more flexibility.
- Click Save to save your settings.
To set specific limits for single disks, use the sensors' channel settings. You can open the channel settings via below the channel gauge or via in the channels table.
- Under Limits, select Enable alerting based on limits.
- Enter the desired Lower Warning Limit. This limit only applies to the respective channel.
- Click OK to save your settings.
If you define channel limits when you also use the sensor's limit setting on the sensor's Settings tab, PRTG takes the first limit that applies. This way, you can individually define harder limits for single disks in a multi-disk sensor. All defined limits are valid.
You have to take the approach via channel settings for sensors that monitor only one (logical) disk, for example, the SNMP Disk Free sensor. For these sensors, you can use multi-edit if you want to automatically apply the same limits to each of these sensors.
- To see all SNMP Disk Free sensors, filter for the sensor type. Select Sensors | By Type | SNMP Disk Free from the main menu bar.
- Enable the check boxes next to the sensors for which you want to set a limit.
- Click .
- Select the Channel Settings tab.
- Select the channel to which you want to add a limit. In this case, select the channel Free Space.
- Enable the check box next to Limits.
- Select Enable alerting based on limits.
- Enter the desired Lower Warning Limit.
- Click OK to save your settings.
The new limit applies to all Free Space channels of all selected sensors.
The value type that you need to configure for limits depends on the type of data that the channel delivers:
For channels that measure absolute values, for example, for free disk space, you have to set limits with absolute values like 20.
For channels that measure delta values, that is, measurements per second (x.xx/sec), you have to set delta values according to the formula number of errors/scanning interval in seconds.
For example, you have an SNMP Traffic sensor and want to receive an alert when the sensor reports errors:
- Set the sensor to the Warning status when 1 error occurs.
- Set the sensor to the Down status when 30 errors occur.
The following screenshot shows how to configure the limits for delta channels. You could set the following limits for the channel Errors in with a standard scanning interval of 60 seconds:
Because this channel uses per second (delta) measurements, the sensor reports a single error that occurs over a standard 60-second scanning interval as 0.016 # per second. So the warning limit for one single error within a scanning interval is 0.1 (errors/sec). To get an alert when there are 30 errors within a scanning interval, the limit needs to be 0.5 (errors/sec).
If no new errors occur in the next scanning interval, the sensor shows the Up status again. To ensure that you do not miss any notifications for this sensor, set a notification trigger with 0 seconds.
You specified limits to define when a sensor shows the Warning (or the Down) status. Now you can create suitable notification triggers. The notification trigger for this example is the state trigger.
For more information about available triggers, see section Notification Triggers Settings.
- Go to the sensor's Notification Triggers tab.
- Hover over and select Add State Trigger from the menu.
- Set the notification trigger to When sensor state is Warning and select the notification template that you created before from the dropdown list.
- Adjust the other notification triggers settings to your needs.
- Click to save the notification trigger.
Now you immediately receive a notification when the capacity of one of your disks falls below the defined limit, in this case 20% of free disk space.
Finally, test the notification that you created. You can immediately trigger a notification for test purposes:
- From the main menu bar, select Setup | Account Settings | Notification Templates.
- Click next to the respective notification template to send a test notification.
- Check if the notification was correctly triggered and delivered based on the notification contacts and the notification method that you defined before. If you do not get a notification or if a defined action is not executed, check the notification logs. To do so, select Logs | System Events | Notification Related from the main menu bar. Look for the triggered notification in the table list and check that you correctly set up the notification delivery.
For more information, see section Logs.