PRTG Manual: Notification Contacts

In the Notification Contacts settings, you can define and change the notification contacts of the user account.

i_round_blueThis 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.

i_podIf 15 minutes (900) seconds have passed since your last credential-based login and you open a system administration page from a different system administration page, PRTG asks you to enter your credentials again for security reasons. A dialog box appears. Enter your Login Name and Password and click OK to continue.

Notification Contacts Tab

Notification Contacts Tab

Notification contacts are unique for each user account. This means that every user can individually define how they want to receive notifications from PRTG. Recipients of notifications are email addresses, phone numbers, push devices (with PRTG for Android or PRTG for iOS), and users of certain instant messaging services.

The notification methods Send Email, Send SMS/Pager Message, and Send Push Notification let you define a user who receives notifications for every active notification contact. If you select a user group, PRTG sends the notifications to all active notification contacts of all users that are in the user group. To exclude notification contacts from the notification delivery, use the Pause button to deactivate them.

Note

You have to take the following four steps to set up and use notifications:

  1. Check and set up the notification delivery settings if you use PRTG on premises. These settings define how PRTG sends messages.
  2. Check and set up notification contacts for the user accounts. These contacts define the recipients to which PRTG sends notifications.
  3. Check and set up several notification templates. These templates define the notification methods and their content.
    i_round_blueYou can also check or edit notification templates via the Notification Triggers tab. For more information, see section Notification Triggers Settings.
  4. Check and set up notification triggers settings for objects. These triggers define when PRTG sends notifications.

i_round_blueUsually, there are three successive attempts to deliver a notification. If all of these attempts fail, the notification is lost. To never miss a notification, we recommend that you always set up at least two notifications with different notification methods for a notification trigger, for example, one email notification and one SMS notification. If delivery via email fails, PRTG can still notify you via smartphone as a fallback. For example, use the latency setting of a state trigger to choose a notification with a different notification method than in the first trigger condition, or set up a second trigger with a different notification method for the corresponding object.

i_square_cyanSee sections Notifications Based on Sensor Limits Step by Step and Notifications Based on Libraries Step by Step for step-by-step guides that describe potential notification setups.

i_square_cyanCustom notification scripts are also available in the PRTG Sensor Hub.

Notification Contacts Overview

Click the Notification Contacts tab to show a list of all notification contacts for the user account. You have the following options:

Option

Description

Pause (b_multi_edit_pause)

Pauses the notification contact. If a notification contact is paused, PRTG does not send any messages to the contact when a notification for this user is triggered.

Resume (b_multi_edit_resume)

Resumes the notification contact. When a notification for this user is triggered, PRTG sends a message to this user.

Edit (b_template_edit)

Open the settings of the notification contact and change its description and recipient.

i_round_blueThis is not possible for predefined notification contacts, for example, for Primary Email Address. You can change the primary email address under My Account.

Delete (b_multi_edit_delete)

Delete the notification contact.

i_round_blueThis is not possible for predefined notification contacts, for example, for Primary Email Address.

Notification Contacts Settings

Hover over b_add and select Add Email Contact or Add SMS Contact from the menu to add a new notification contact. You can also click the b_template_edit next to a notification contact to edit it.

i_round_bluePRTG automatically adds push contacts for the corresponding user when you install a PRTG app for iOS or Android on your smartphone or tablet, connect to PRTG, and activate push notifications. You cannot manually add push contacts. If your mobile device actively rejects push notifications for a push contact, for example, because you deactivate push on the target device or reset it, PRTG automatically pauses the push contact. The affected user account receives a ToDo ticket in this case.

Add New Notification Contact

Add New Notification Contact

Add Email Contact

Setting

Description

Description

Enter a meaningful description for the email contact.

i_round_blueIf the name contains angle brackets (<>), PRTG replaces them with braces ({}) for security reasons. For more information, see the Knowledge Base: What security features does PRTG include?

Recipient

Enter a valid email address for the email contact.

i_square_cyanFor the contact type Push, this field shows a unique token that you cannot change. PRTG uses this token to send push notifications through the cloud. For details, see the Knowledge Base: How can I use push notifications with PRTG?

Contact Type

Shows the type of the notification contact.

i_round_blueThis setting is for your information only. You cannot change it.

i_round_blueIf you want to use a different contact type, create a new contact with Add Email Contact or Add SMS Contact, or activate push notifications in your PRTG for iOS or Android app.

Click OK to save your settings, or click Cancel to close the dialog box without changes to the notification contact.

Add SMS Contact

Setting

Description

Description

Enter a meaningful description for the SMS contact.

i_round_blueIf the name contains angle brackets (<>), PRTG replaces them with braces ({}) for security reasons. For more information, see the Knowledge Base: What security features does PRTG include?

Recipient

Enter a valid phone number for the SMS contact. The format of the phone number depends on the SMS provider. You can use a plus sign (+) or 00, followed by the country code and the number. For example, +1555012345 or 001555012345.

i_round_redMake sure that the number format meets the requirements of your SMS provider or the hardware that you use in combination with an application programming interface (API) call. Sometimes a preceding plus sign is not required. The wrong format might result in undelivered messages.

i_square_cyanFor the contact type Push, this field shows a unique token that you cannot change. PRTG uses this token to send push notifications through the cloud. For details, see the Knowledge Base: How can I use push notifications with PRTG?

Contact Type

Shows the type of the notification contact.

i_round_blueThis setting is for your information only. You cannot change it.

i_round_blueIf you want to use a different contact type, create a new contact with Add Email Contact or Add SMS Contact, or activate push notifications in your PRTG for iOS or Android app.

Click OK to save your settings, or click Cancel to close the dialog box without changes to the notification contact.

More

i_square_blueKNOWLEDGE BASE

What security features does PRTG include?

How can I use push notifications with PRTG?

 

i_square_bluePAESSLER WEBSITE

You can find custom notification scripts in the PRTG Sensor Hub

Setup

Others

There are some settings that you must make in the PRTG Administration Tool. For more details, see the sections: