<%NUMBERING1%>.<%NUMBERING2%>.<%NUMBERING3%> PRTG Manual: Notification Templates

Send test notification ()

Triggers the notification immediately for testing purposes.

When you test notifications, PRTG does not resolve the placeholders, but rather sends the original variables instead.

Used by ()

Show all objects that trigger the notification.

Pause ()

Pauses the notification.

If you manually pause a notification, PRTG does not send messages when this notification is triggered.

Resume ()

Resumes the notification.

Clone ()

Creates a clone of the notification.

Delete ()

Deletes the notification.

You cannot delete predefined notifications.

Settings ()

Opens the settings of a notification template.

Template Name

Enter a name to identify the notification template.

If 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?

Tags

Enter one or more tags. Confirm each tag with the Spacebar key, a comma, or the Enter key. You can use tags to group objects and use tag-filtered views later on. Tags are not case-sensitive. Tags are automatically inherited.

For performance reasons, it can take some minutes until you can filter for new tags that you added.

Status

Select the status of the notification template:

• Started (default): PRTG executes the notifications that are defined in the notification template whenever it is triggered.
• Paused: PRTG does not execute any notifications that are defined in the notification template.

Schedule

Define if you want to use a schedule to activate a notification template only during specific time spans:

• None
• Saturdays
• Sundays
• Weekdays
• Weekdays Eight-To-Eight (08:00 - 20:00)
• Weekdays Nights (17:00 - 09:00)
• Weekdays Nights (20:00 - 08:00)
• Weekdays Nine-To-Five (09:00 - 17:00)
• Weekends

Use this setting to pause notifications, for example, during regular maintenance periods or system restarts.

The overall status of the notification template must be Started (default) to apply any schedule settings.

For more information, see section Schedules.

Notification Handling during Scheduled Pause

Define how PRTG handles notifications that are triggered during a scheduled pause:

• Collect notifications and send them when reactivated: PRTG collects all notifications that are triggered during a scheduled pause and sends them all out once the paused status ends.
• Discard notifications during paused status: PRTG discards all notifications that are triggered during a scheduled pause.

If you manually pause a notification, PRTG never collects notifications that are triggered while the notification is paused.

Method

Define if and how PRTG collects and summarizes several notifications into one or more messages with a maximum of 1,000 characters:

• Always notify immediately, never summarize: PRTG always sends out one notification for each notification trigger that it receives as soon as possible, for example, immediately.
• Send first down message immediately, then summarize: When PRTG receives several down triggers, it sends the first notification immediately, then it continues to summarize notification triggers into one message, regardless of the sensor status.
• Send first down and up message immediately, then summarize: When PRTG receives several down or up triggers, it sends each first notification immediately, then it continues to summarize notification triggers into one message, regardless of the sensor status.
• Send all down messages immediately, summarize the others: When PRTG receives several down triggers, it sends out one notification for each trigger that it receives, but it summarizes notifications for all non-down triggers into one message.
• Send all down and up messages immediately, summarize the others: When PRTG receives several down or up triggers, it sends out one notification for each trigger that it receives, but it summarizes the notifications for all non-down and non-up triggers into one message.
• Always summarize notifications, regardless of type: When PRTG receives several notification triggers, it summarizes the notifications, regardless of the kind of notification trigger that it receives.
  The maximum number of notifications (see below) still applies.

Regardless of the option that you choose, PRTG never summarizes notifications of the types Send Slack Message, Send Microsoft Teams Message, Execute HTTP Action, Execute Program, and Assign Ticket because it always sends them immediately. PRTG can summarize the messages of all other notification types.

'first down' and 'first up' messages refer to the notification trigger condition and the clear condition respectively. You can also define warning or unusual states as notification trigger conditions or even thresholds or other triggers notification summarizations. The condition clear triggers, if applicable, are defined in the respective notification trigger conditions as well. The notification triggers all qualify as 'first down' or 'first up' messages.

PRTG collects up to 25 single notifications for one summarization and sends out the message as soon as this number is reached (or when the gathering time passes). If PRTG receives more than 25 notifications within the defined time span, you receive more than one message with up to 25 entries each. For example, if PRTG collects 74 notifications, this results in 3 summarized messages with 25, 25, and 24 collected notifications.

Subject for Summarized Email or SNS Messages

Define a subject that PRTG includes when it sends summarized notifications. The default subject is [%sitename%] %summarycount Summarized Notifications.

PRTG only uses the subject for the notification methods Send Email and Send Amazon Simple Notification Service Message.

You can use placeholders. For more information, see section Placeholders for Notifications.

Time Span for Summarizing Messages (in Minutes)

Define a time span in minutes to define how long PRTG collects notifications for summarization. Enter an integer.

If you enter a long time span, for example, 60 minutes, PRTG collects notifications for one hour before it sends them out summarized unless other features (see above) require an earlier message dispatch.

User Group Access

Define the user groups that have access to the notification template. You see a table with user groups and group access rights. The table contains all user groups in your setup. For each user group, you can choose from the following group access rights:

• No access: Users in this user group cannot see or edit the notification template. The object does not show up in lists.
• Read access: Users in this user group can see the notification template and view its settings.
• Write access: Users in this user group can see the notification template and view and edit its settings. However, they cannot edit its access rights settings.
• Full access: Users in this user group can see the notification template, view and edit its settings, and edit its access rights settings.

You can create new user groups in the User Groups settings.

Sender

Define which sender email address and sender name appear in the FROM part of the email notifications:

• Default: Use the default sender email address and sender name from the notification delivery settings.
• Custom: Enter a custom sender email address and sender name.

Sender Email Address

This setting is only visible if you select Custom above.

Enter an email address to use as the sender of the email notifications.

If you enter a custom sender email address, it overrides the email address in the notification delivery settings.

The outgoing Simple Mail Transfer Protocol (SMTP) server in the notification delivery settings must allow the email address so that it can deliver email notifications.

Sender Name

This setting is only visible if you select Custom above.

Enter a sender name to use as the sender of the email notifications.

If you enter a custom sender name, it overrides the sender name in the notification delivery settings.

Send to User

Select a user account to send the email notifications to. PRTG sends the email notifications to every active email notification contact for this user account. Leave None to not use this option.

Read/write users can send notifications to any user that is a member of the same user group as the read/write user.

Send to User, Send to User Group, and Send to Email Address all work simultaneously. Because of this, you can define more than one user as a recipient of this notification. PRTG sends the email notifications to the active email notification contacts of the user that you select, to the active email notification contacts of all members of the user group that you select, and to all email addresses that you enter under Send to Email Address.

Send to User Group

Select a user group to send the email notifications to all members of this user group. PRTG sends the email notifications to every active email notification contact of every user in the user group. Leave None to not use this option.

If you select a user group and a specific member of this user group as recipients, the user only receives one single email. This also applies if you enter an individual email address under Send to Email Address that is already defined as an email notification contact of the selected user.

If you define individual email addresses under Send to Email Address, define a specific user account under Send to User, and define a user group here, PRTG sends the message to the individual email addresses, to the individual user, as well as to the members of the selected user group. In all cases, PRTG sends one message with all recipients in the To part of the email.

Read/write users can send email notifications to all user groups that they are members of.

Send to User, Send to User Group, and Send to Email Address all work simultaneously. Because of this, you can define more than one user as a recipient of this notification. PRTG sends the email notifications to the active email notification contacts of the user that you select, to the active email notification contacts of all members of the user group that you select, and to all email addresses that you enter under Send to Email Address.

Send to Email Address

Enter one or more email addresses to which PRTG sends the email notifications. If you enter more than one email address, separate them with commas. Leave this field empty to only send email notifications to the email notification contacts of the user or to the members of the user group you choose above.

We recommend that you use Send to User and/or Send to User Group instead because you can then manage the notification contacts of users.

Send to User, Send to User Group, and Send to Email Address all work simultaneously. Because of this, you can define more than one user as a recipient of this notification. PRTG sends the email notifications to the active email notification contacts of the user that you select, to the active email notification contacts of all members of the user group that you select, and to all email addresses that you enter under Send to Email Address.

Subject

Enter the subject of the email notifications. The default subject is [%sitename] %device %name %status %down (%message).

You can use placeholders. For more information, see section Placeholders for Notifications.

Format

Define the kind of email that PRTG sends when the notification is triggered:

• HTML: PRTG uses the default HTML email template for the message part of the email.

Make sure that your email client can show HTML emails, otherwise you cannot read emails from PRTG.

• Text: PRTG uses the default plain text email template for the message part of the email.
• Custom text: PRTG uses custom plain text for the message part of the email. Define a custom text below.

Custom Text

This setting is only visible if you select Custom text above.

Enter the desired message for this email notification in plain text format. You can use placeholders here.

For more information, see section Placeholders for Notifications.

Priority

Define the priority that PRTG sets for the email:

• Very High
• High
• Medium
• Low
• Very Low

Most email clients can show this priority flag.

HTTP Version

Define the HTTP version that PRTG uses to send the email:

• HTTP 1.1 (default): Use HTTP version 1.1.
• HTTP 1.0: Use HTTP version 1.0.

Log File

Define the log file to which PRTG adds an event:

• Application: PRTG adds an entry to the Application log file under Windows Logs in the event log
• PRTG Network Monitor: PRTG adds an entry to the PRTG Network Monitor log file under Applications and Services Logs in the event log.

Event Source

This setting is only visible if you select Application above.

Enter the source for the event. This is usually the name of the application.

Event Type

Select the type of the event:

• Error: An event that indicates a significant problem such as loss of data or loss of functionality. For example, if a service fails to load during startup, an Error event is logged.
• Warning: An event that is not necessarily significant, but might indicate a possible future problem. For example, when disk space is low, a Warning event is logged.
• Information: An event that describes the successful operation of an application, driver, or service. For example, when a network driver loads successfully, it might be appropriate to log an Information event.

Message

Define the message that PRTG writes in the event log. The default message is [%sitename] %device %name %status %down (%message).

To reset this field to the default value, enter only an asterisk (*).

You can use placeholders. For more information, see section Placeholders for Notifications.

Send to User

Select a user account from the dropdown list. PRTG sends the SMS/pager message to every SMS notification contact for the user account. Leave None to not use this option.

Send to User Group

Select a user group from the dropdown list. PRTG sends the SMS/pager message to every SMS notification contact for every member of the user group.Leave None to not use this option.

If you select a user group and a specific member of this user group as recipients at the same time, this user receives the SMS/pager message only once. This also applies if you enter an individual phone number below that is already defined as an SMS notification contact for the selected user.

Send to Phone Number

Enter a phone number to send the SMS/pager message to. If you enter more than one phone number, use commas as separators.

The format depends on the SMS provider. Usually, you use a plus sign (+), followed by the country code and the number. For example, +1555012345.

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

We recommend that you use Send to User and/or Send to User Group instead because you can then manage the notification contacts of users.

Message

Define the SMS/pager message. The default message is [%sitename] %device %name %status %down (%message).

To reset this field to the default value, enter only an asterisk (*).

You can use placeholders. For more information, see section Placeholders for Notifications.

HTTP Version

Define the HTTP version that PRTG uses to send the SMS/pager message:

• HTTP 1.1 (default): Use HTTP version 1.1.
• HTTP 1.0: Use HTTP version 1.0.

URL

Enter the URL that PRTG sends the request to.

HTTP notifications work with or without Secure Sockets Layer (SSL).

You can use placeholders. For more information, see section Placeholders for Notifications.

SNI Handling

Define if PRTG sends the Server Name Indication (SNI) extension to the Transport Layer Security (TLS) protocol along with the HTTP request:

• Do not send SNI (default): PRTG does not send the SNI when it executes the HTTP action.
• Send SNI: PRTG sends the SNI when it calls the target URL. Specify the SNI below.

SNI Name

This setting is only visible if you select Send SNI above.

Enter the SNI name that the endpoint configuration requires. Usually, this is the fully qualified domain name (FQDN) of the virtual host.

HTTP Method

Select the HTTP method that the notification uses:

• GET (default): Use the GET method.

• POST: Use the POST method.
• PUT: Use the PUT method.

• PATCH: Use the PATCH method.

Payload

This setting is only visible if you select POST, PUT, or PATCH above.

Enter a payload. The payload is the data that PRTG transmits to the URL.

You cannot use Extensible Markup Language (XML) or JavaScript Object Notation (JSON).

Only the content type application/x-www-form-urlencoded is supported.

You can use line breaks.

You can use placeholders. For more information, see section Placeholders for Notifications.

HTTP Version

This setting is only visible if you select POST above.

Select the HTTP version that PRTG uses to execute the HTTP action:

• HTTP 1.1 (default): Use HTTP version 1.1.
• HTTP 1.0: Use HTTP version 1.0.

Make sure that the target supports the HTTP version that you select.

Executable File

Select an executable file from the list. PRTG runs it every time the notification is triggered.

You see the files that are in the corresponding \Notifications\EXE subfolder of the PRTG program directory. For files to appear in this list, store them as .bat, .cmd, .exe, .com, .ps1, or .vbs.

In a cluster, copy the files to every cluster node. This makes sure that PRTG can execute the notification even when the master node fails. If your custom notification executes an external program, install it on all cluster nodes as well.

Parameters

Enter the parameters that the notification passes to the executable. For example, if you use a batch file that contains a %1 variable, you can provide a value for this variable. The default parameters are [%sitename] %device %name %status %down (%message).

You can use placeholders. For more information, see section Placeholders for Notifications.

You need to escape special characters and whitespaces in your parameters and surround them with double quotation marks ("). See section Escape Special Characters and Whitespaces in Parameters for details.

Domain or Computer Name

Enter a Windows authority if you want to use a different security context for the program than the security context of the PRTG core server.

User Name

Enter the user name for Windows access.

Password

Enter the password for Windows access.

Timeout (Sec.)

Enter a timeout in seconds. After this time passes, PRTG stops the process if it is still running. Enter an integer.

Host/IP Address

Define the IP address or the Domain Name System (DNS) name of the system that runs the syslog server.

You can receive and analyze syslog messages with the Syslog Receiver sensor.

Syslog Port

Enter the port that PRTG sends the syslog messages to. The default port is 514.

You can only use the User Datagram Protocol (UDP).

Facility

Define the facility of the syslog messages:

• User-level messages
• Local use 0-7

Encoding

Define the encoding of the syslog messages that PRTG sends to the syslog receiver:

• ANSI
• UTF-8

Make sure that the syslog receiver supports the encoding that you select.

Message

Define the syslog message. The default message is [%sitename] %device %name %status %down (%message).

To reset this field to the default value, enter only an asterisk (*).

You can use placeholders. For more information, see section Placeholders for Notifications.

Up

Notice (5)

Warning

Warning (4)

Down

Error (3)

Host/IP Address

Define the IP address or DNS name of the system that runs the trap receiver.

You can receive and analyze SNMP trap messages with the SNMP Trap Receiver sensor.

SNMP Port

Enter the port on which PRTG sends trap messages. The default port is 162.

Community String

Enter the community string of the device. The default community string is public. Enter a string or leave the field empty.

Custom Trap Code

Enter a code to identify the purpose of the trap. The default trap code is 0. Enter an integer.

Message ID

Enter an ID to identify the origin of the trap.Enter an integer. PRTG sends it on the OID 1.3.6.1.4.1.32446.1.1.1.

Message

Define the trap message.

To reset this field to the default value, enter only an asterisk (*).

You can use placeholders. For more information, see section Placeholders for Notifications.

Agent IP

Define the IP address of the agent. Leave this field empty to use the IP address of the PRTG web server.

Include Sensor ID

Define if PRTG should include the sensor ID of the sensor that triggers the notification:

• Do not include sensor ID (default): Do not include the sensor ID with the notification message.
• Include sensor ID: Include the sensor ID with the notification message. PRTG sends it on the OID 1.3.6.1.4.1.32446.1.1.5.

AWS Access Key ID

Enter your access key ID from aws.amazon.com. Enter a string.

AWS Secret Access Key

Enter your secret access key from aws.amazon.com. Enter a string.

Location

Define the location of your Amazon service:

• Africa (Cape Town)
• Asia Pacific (Hong Kong)
• Asia Pacific (Mumbai)
• Asia Pacific (Osaka)
• Asia Pacific (Seoul)
• Asia Pacific (Singapore)
• Asia Pacific (Sydney)
• Asia Pacific (Tokyo)
• Canada (Central)
• China (Beijing)
• China (Ningxia)
• Europe (Frankfurt)
• Europe (Stockholm)
• Europe (Milan)
• Europe (Ireland)
• Europe (London)
• Europe (Paris)
• Middle East (Bahrain)
• South America (São Paulo)
• US East (Northern Virginia)
• US East (Ohio)
• US West (Northern California)
• US West (Oregon)

Amazon Resource Name

Enter the Amazon resource name. Enter a string.

Subject

Enter the subject of the Amazon Simple Notification Service (SNS) message. Enter a string.

The maximum length for the subject is 202 characters. PRTG ignores characters that exceed this length.

Message

Define the SNS message. The default SNS message is [%sitename] %device %name %status %down (%message).

To reset this field to the default value, enter only an asterisk (*).

You can use placeholders. For more information, see section Placeholders for Notifications.

PRTG only sends the message if you use email-based notifications delivered by Amazon SNS. For SMS delivery, PRTG only sends the subject and ignores the message because of SMS size restrictions.

Assign to User Group or User

Specify whether to assign the notification ticket to a user group or to a single user:

• To user group: Assign the notification ticket to a user group.
• To user: Assign the notification ticket to a single user.

User Group

Select the user group to which PRTG assigns the notification ticket.

Read/write users can assign tickets to all user groups that they are a member of as well as to administrators and individual users that are members of the same user group as the read/write user.

User

Select the user to which PRTG assigns the notification ticket.

Read/write users can assign tickets to all user groups that they are a member of as well as to administrators and individual users that are members of the same user group as the read/write user.

Subject

Enter the subject of the notification ticket. The default subject is %device %name %status %down (%message).

You can use placeholders. For more information, see section Placeholders for Notifications.

Content

Enter the message of the notification ticket. The default message is

Sensor: %name
Status: %status %down

Date/Time: %datetime (%timezone)
Last Result: %lastvalue
Last Message: %message

Probe: %probe
Group: %group
Device: %device (%host)

Last Scan: %lastcheck
Last Up: %lastup
Last Down: %lastdown
Uptime: %uptime
Downtime: %downtime
Cumulated since: %cumsince
Location: %location

To reset this field to the default value, enter only an asterisk (*).

You can use placeholders. For more information, see section Placeholders for Notifications.

When Condition Clears

Define how PRTG handles the notification ticket when the defined trigger condition clears:

• Close the notification ticket (recommended): Automatically close the notification ticket if the trigger condition is not met anymore.
• Do not close the notification ticket: Do not close the notification ticket after the condition clears.

Send to User

Select the user that PRTG sends push notifications to. PRTG sends the push notifications to each active push notification contact of the user. Leave None to not use this option.

You can edit push notification contacts of a user in the Notification Contacts settings and also activate push notifications in the Android or iOS app with the user.

Send to User Group

Select the user group that PRTG sends push notifications to. PRTG sends the push notifications to each active push notification contact of every member of the group. Leave None to not use this option.

If you select a user group and a specific member of the group as recipients at the same time, the user receives the text message only one time.

You can edit user groups in the User Groups settings and push notification contacts in the Notification Contacts settings.

Message

Define the message of the push notification. The default message is [%sitename] %device %name %status %down (%message).

To reset this field to the default value, enter only an asterisk (*).

You can use placeholders. For more information, see section Placeholders for Notifications.

HTTP Version

Define the HTTP version that PRTG uses to send the push notification:

• HTTP 1.1 (default): Use HTTP version 1.1.
• HTTP 1.0: Use HTTP version 1.0.

Teams Webhook URL

Enter the URL of the incoming webhook that you set up in your Microsoft Teams channel.

For more information, see the Knowledge Base: How do I create a webhook for the PRTG Notifications to Slack and Microsoft Teams?

Title

Enter the title of the Microsoft Teams notification. The default title is Enter value.

You can use placeholders. For more information, see section Placeholders for Notifications.

Subtitle

Enter the subtitle of the Microsoft Teams notification. The default subtitle is %message.

You can use placeholders. For more information, see section Placeholders for Notifications.

Content

Define the content of the Microsoft Teams notification:

• Use default content: Use the default notification message content. This includes information about the Status, Last Scan, Last Value, Last Up, Coverage, Downtime, Priority, Probe, and Group.
• Define custom content: Define custom notification message content. Choose Custom Content below.

Custom Content

This setting is only visible if you select Define custom content above.

Enable the check boxes in front of content that you want PRTG to include in the Microsoft Teams notifications. Disable the check boxes in front of the content that you do not want to include.

The following types of monitoring information are available:

• Name
• Host
• Status
• Last scan
• Last value
• Message
• Last down
• Last up
• Coverage
• Downtime
• Uptime
• Priority
• Probe
• Group
• Device
• Date and time
• Time zone
• Comments (probe)
• Comments (group)
• Comments (device)
• Comments (sensor)
• History

For more information, see section Placeholders for Notifications.

Slack Webhook URL

Enter the URL of the incoming webhook that you set up in your Slack workspace.

For more information, see the Knowledge Base: How do I create a webhook for the PRTG Notifications to Slack and Microsoft Teams?

Sender Name

Enter a sender name to use as the sender of Slack notifications.

This field overrides the sender that you might have defined in your Slack workspace.

Title

Enter the title of the Slack notifications. The default title is Enter value.

You can use placeholders. For more information, see section Placeholders for Notifications.

Subtitle

Enter the subtitle of the Slack notifications. The default subtitle is %message.

You can use placeholders. For more information, see section Placeholders for Notifications.

Content

Define the content of the Slack notifications:

• Use default content: Use the default notification message content. This includes information about the Status, Last Scan, Last Value, Last Up, Coverage, Downtime, Priority, Probe, and Group.
• Define custom content: Define custom notification message content. Choose Custom Content below.

Custom Content

This setting is only visible if you select Define custom content above.

Enable the check boxes in front of the content that you want PRTG to include in the Slack notifications. Disable the check boxes in front of the content that you do not want to include.

The following types of monitoring information are available:

• Name
• Host
• Status
• Last scan
• Last value
• Message
• Last down
• Last up
• Coverage
• Downtime
• Uptime
• Priority
• Probe
• Group
• Device
• Date and time
• Time zone
• Comments (probe)
• Comments (group)
• Comments (device)
• Comments (sensor)
• History

For more information, see section Placeholders for Notifications.

MQTT Broker

Enter the address for the connection to the MQTT broker (server).

Port

Enter the port for the connection to the MQTT broker. The default port for secure connections is 8883 and the default port for unsecure connections is 1883.

Timeout (Sec.)

Enter a timeout in seconds for the request. Enter an integer. The maximum timeout value is 300 seconds (5 minutes).

User Authentication

Select if you want to connect without credentials or define credentials for access to the MQTT broker:

• None (default): Connect without credentials.
• User name and password: Define credentials for the connection.

User Name

Enter the user name for access to the Message Queue Telemetry Transport (MQTT) broker.

Password

Enter the password for access to the MQTT broker.

Transport-Level Security

Select if you want to use a Secure Sockets Layer (SSL)/Transport Layer Security (TLS) secured connection:

• Do not use transport-level security (default): Establish the connection without connection security.
• Use transport-level security: Establish the connection with the strongest SSL/TLS method that the target device provides.

Server Authentication

This setting is only visible if you select Use transport-level security above.

Select if you want to use a certificate for server authentication:

• Disable (default): Do not use a certificate for server authentication.
• Enable: Use a certificate for server authentication.

CA Certificate

Paste the certificate authority (CA) certificate for the verification of the MQTT broker.

The certificate must be in Privacy-Enhanced Mail (PEM) format.

Client Authentication

This setting is only visible if you select Use transport-level security above.

Select if you want to use a certificate for client authentication:

• Disable (default): Do not use a certificate for client authentication.
• Enable: Use a certificate for client authentication.

Client Certificate

Paste the certificate that you created for authenticating the sensor against the MQTT broker.

The certificate must be in PEM format.

Client Key

Enter the client key for access to the MQTT broker.

The client key must be in PEM format and it must be encrypted using the Client Key Password.

Client Key Password

Enter the password for the client key certificate.

MQTT Topic

Enter the topic for the MQTT publish notifications. The default topic is PRTG/%sitename/notifications.

MQTT clients that are subscribed to this topic receive the MQTT publish notifications.

ClientID

Enter the ClientID for the connection to the MQTT broker (server). The default ClientID is PRTG - %sitename.

Message

Define the message of the MQTT publish notifications. The default message is PRTG - [%sitename] %device %name %status %down (%message).

To reset this field to the default value, enter only an asterisk (*).

You can use placeholders. For more information, see section Placeholders for Notifications.

OPC UA Server

Enter the address for the connection to the OPC Unified Architecture (OPC UA) server.

Port

Enter the port for the connection to the OPC UA server. The default port for secure connections is 4843. The default port for unsecure connections is 4840.

Server Path

Enter the path of the OPC UA server endpoint if you run more than one server under the same IP address or DNS name.

NodeID

Enter the NodeID for the OPC UA notification. PRTG writes the data that you define below to the specified NodeID.

Timeout (Sec.)

Enter a timeout in seconds for the request.

Security Mode

Select if you want to use encryption:

• None (default): Do not use encryption.
• Sign: Sign messages between the sensor and the OPC UA server.
• Sign & Encrypt: Sign and encrypt messages between the sensor and the OPC UA server.

Security Policy

This setting is only visible if you select Sign or Sign & Encrypt above.

Select if you want to use a security policy and define which policy you want to use:

• None (default): Do not use a security policy.
• Basic256Sha256: Use the Basic256Sha256 security policy.
• Basic256: Use the Basic256 security policy.

Client Certificate

This setting is only visible if you select Sign or Sign & Encrypt above.

Enter the certificate that you created for authenticating the sensor against the OPC UA server.

The certificate must meet the following requirements:

• The key size must be 2048-bit or 4096-bit.
• The secure hash algorithm must be SHA256.
• DataEncipherment must be part of the KeyUsage certificate extension.
• A uniform resource indicator (URI) must be set in subjectAltName.
• The certificate must be in Privacy-Enhanced Mail (PEM) format.

Client Key

This setting is only visible if you select Sign or Sign & Encrypt above.

Enter the client key for access to the OPC UA server.

The client key must be in PEM format and it must be encrypted using the Client Key Password.

Client Key Password

This setting is only visible if you select Sign or Sign & Encrypt above.

Enter the password for the client key.

Authentication Method

Select if you want to connect without credentials or define credentials for access to the OPC UA server:

• Anonymous (default): Connect without credentials.
• User name and password: Define credentials for the connection.

Most OPC UA servers do not support User name and password authentication without a client certificate. To use User name and password authentication, select Sign or Sign & Encrypt under Security Mode and Basic256Sha256 or Basic256 under Security Policy and enter the Client Certificate, Client Key, and Client Key Password that you want to use.

If you select None (default) under Security Mode and use User name and password authentication, PRTG sends the unencrypted password to the OPC UA server.

Most OPC UA servers do not support User name and password authentication without a client certificate. To use User name and password authentication, select Sign or Sign & Encrypt under Security Mode and Basic256Sha256 or Basic256 under Security Policy and enter the Client Certificate, Client Key, and Client Key Password that you want to use.

User Name

This setting is only visible if you select User name and password above.

Enter the user name for access to the OPC UA server.

Password

This setting is only visible if you select User name and password above.

Enter the password for access to the OPC UA server.

Data Type

Select the type of the data that PRTG sends:

• Boolean: PRTG sends a Boolean.
• Int64: PRTG sends a 64-bit integer.
• Double: PRTG sends a double value.

Boolean

This setting is only visible if you select Boolean above.

Select the Boolean value that PRTG sends:

• True (default)
• False

If you select Boolean as Data Type, the data type on the OPC UA server must be Boolean.

Int64

This setting is only visible if you select Int64 above.

Enter the 64-bit integer that PRTG sends.

If you select Int64 as Data Type, the data type on the OPC UA server must be Int64.

Double

This setting is only visible if you select Double above.

Enter the double value that PRTG sends.

If you select Double as Data Type, the data type on the OPC UA server must be Double.