In Flashduty On-call
You can get the integration push URL in either of the following ways.
Use a dedicated integration
- In the Flashduty console, go to Channels and open a channel
- Select Configuration → Integrations → Private integration, then click Add an integration
- Select PRTG and click Save
- Open the new integration card and copy the push URL
Use a shared integration
- In the Flashduty console, go to Integration Center → Alert Events
- Select PRTG and enter an integration name
- Configure the default route and select a channel. You can add more rules under Routes after creation
- Click Save and copy the generated push URL
Configure PRTG
PRTG needs two notification templates: one sent when a sensor enters an alert state (
event=trigger) and one sent when it leaves that state (event=resolve). Both templates use the same push URL and the same fields; only the leading event differs.
1
Create the alert notification template
- Sign in to PRTG as an administrator, go to Setup → Account Settings → Notification Templates, and click Add Notification Template
- Enter
Flashduty alertas the Template Name - Select Execute HTTP Action and fill it in as follows:
Alert template:
- Click Create
2
Create the recovery notification template
Create a second template the same way. Enter You can send a test notification for a template from the Notification Templates list to check the URL. PRTG does not resolve placeholders in test notifications; Flashduty recognizes them, answers with success, and creates no alert.
Flashduty recovery as the Template Name and use the recovery template below as the Payload; keep every other setting the same:3
Add a state trigger
- Open the object to connect (the Root group, a group, a device, or a sensor), go to the Notification Triggers tab, and select Add State Trigger
- Fill it in as follows:
- Save the trigger. Child groups, devices, and sensors inherit it
Flashduty alert for it too; it merges into the same alert.4
Verify the lifecycle
Put a sensor into the Down state for real (for example, briefly cut the network to the address a Ping sensor checks), wait for the trigger latency, and confirm that Flashduty receives an active alert. After the sensor recovers, confirm that the same alert is closed.
Payload fields
PRTG posts the template fields as an
application/x-www-form-urlencoded form. Each field is named after the PRTG placeholder that fills it:
The alert title is
<device name>: <sensor name>. If the device name is empty, Flashduty uses the sensor name alone; if both are empty, it uses PRTG sensor <sensorid>.
Alert Key
Flashduty uses
sensorid as the Alert Key. Alert, escalation, and recovery notifications for the same sensor carry the same sensor ID, so they land on the same alert. Two sensors with the same name on one device have different IDs and produce different alerts. Changing the sensor name, device name, status, or message does not change the Alert Key.
Sensor IDs are unique only within one PRTG server. Use a separate Flashduty integration for each PRTG server, so that sensors with the same ID on different servers do not merge into one alert.
Status and severity
event decides whether the alert triggers or recovers, and laststatus decides the severity:
Requests with an empty or any other
event are rejected, so a request whose state cannot be determined never enters the wrong alert lifecycle.
FAQ
Why are two notification templates needed?
Why are two notification templates needed?
No PRTG placeholder tells whether a notification comes from a state trigger firing or from its no longer recovery, so the fixed
event value in the template says it. laststatus only describes the sensor’s current status: when a sensor moves from Down to Warning, the Down trigger’s recovery notification carries laststatus Warning. Deciding recovery by event closes each trigger’s alert on time.What happens when a sensor moves from Down to Warning?
What happens when a sensor moves from Down to Warning?
The Down trigger sends its recovery notification, which closes the Down alert. If a Warning state trigger is configured, it sends an alert notification after its latency and reopens an alert for the sensor with Warning severity.
PRTG is not in English and the severity is wrong
PRTG is not in English and the severity is wrong
The
laststatus value PRTG sends is translated with the PRTG language setting. Flashduty recognizes English status names only and treats any other status name as Warning. Triggering and recovery are decided by event and do not depend on the language.PRTG reports the notification as sent, but Flashduty received nothing
PRTG reports the notification as sent, but Flashduty received nothing
Check that SNI Handling is set to Send SNI and that SNI Name matches the host name in the push URL. Without SNI, the request may never reach Flashduty while PRTG still reports success.
Troubleshooting
- PRTG fails to send: check that the URL is the complete push URL including
integration_key, and that HTTP Method is POST - Flashduty returns a parameter error: check that the Payload contains the whole template on one line, including
eventandsensorid - The alert does not recover: check that the state trigger’s no longer … perform uses the
Flashduty recoverytemplate, and that the recovery and alert notifications come from the same sensor