What is this?

This knowledgebase contains questions and answers about PRTG Network Monitor and network monitoring in general. You are invited to get involved by asking and answering questions!

Learn more

PRTG Network Monitor

Intuitive to Use. Easy to manage.
300.000 administrators have chosen PRTG to monitor their network. Find out how you can reduce cost, increase QoS and ease planning, as well.

Free Download

Top Tags


View all Tags

How can I integrate Derdack Enterprise Alert into PRTG?

Votes:

0

Your Vote:

Up

Down

PRTG can send notifications but it does not track these notifications to make sure that they are received and resolved. Is it therefore possible to integrate Derdack Enterprise Alert into PRTG? What steps do I have to take?

derdack enterprise-alert integration prtg

Created on May 7, 2021 6:47:02 AM by  Maike Guba [Paessler Support]

Last change on May 26, 2021 5:07:51 AM by  Maike Guba [Paessler Support]



1 Reply

Accepted Answer

Votes:

0

Your Vote:

Up

Down

This article applies as of PRTG 21

Integration of Derdack Enterprise Alert into PRTG

Derdack Enterprise Alert is an alerting solution that offers multiple notification channels and multiple escalation tiers to make sure that alerts, in this case notifications from PRTG, are received, acknowledged, and resolved. You can integrate Enterprise Alert into PRTG via emails, the REST API, and webhooks. In this article, you can read about the integration via email and the REST API.

Option 1: Integration via email

Configure PRTG

  1. Log in to the PRTG web interface.
  2. Select Setup | Account Settings | Notification Templates from the main menu.
  3. Hover over the plus button on the right side and click Add Notification Template.
    Add new notification template
    Click to enlarge.
  4. Enter a Template Name, for example, Enterprise Alert Email.
    Name new notification template
    Click to enlarge.
  5. Scroll down to the notification methods and enable the method Send Email. Then do the following:
    • Set the Sender option to Custom.
    • Enter a Sender Email Address. This is the email address that appears in the From field of the email.
    • Enter a Sender Name, for example, PRTG Network Monitor.
    • In the Send to Email Address field, enter the email address that you set up in Enterprise Alert.
    • Leave the Format setting as it is unless the system cannot read HTML. In this case, select Text.
    • You can leave all other settings unchanged.
    • Click Create.
      Configure notification method
      Click to enlarge.
  6. Navigate to the sensor that you want to create a notification for in case of an alarm.
  7. Select the Notification Triggers tab.
  8. Hover over the plus button on the right side and select Add State Trigger.
    Add notification trigger
    Click to enlarge.
  9. Configure the state trigger according to your needs. Make sure that you set the previously configured notification template Enterprise Alert Email as the action for the first two conditions.
    Configure notification trigger
    Click to enlarge.
  10. Click the blue check mark to save your settings.

Configure Enterprise Alert

  1. Log in to the Enterprise Alert portal.
  2. Create a new event.
  3. On the General tab, give the sensor a meaningful Name.
  4. As Event Source, select Incoming Messages | E-mail from the dropdown menu.
    Set up email event
    Click to enlarge.
  5. Click Next.
  6. On the Conditions tab, add conditions to set Enterprise Alert to only activate if it receives an email of the type that you previously created.
    Set up alerting conditions
    Click to enlarge.
  7. Click Next.
  8. On the Alerting tab, select the Destination, that is, the users or the teams that Enterprise Alert needs to alert.
  9. Define the respective Notification Channel for each user or team.
    Set up destinations and notification channels
    Click to enlarge.
  10. Click Next.
  11. On the Message tab, you can configure the alert message that Enterprise Alert sends to a user or team. Enter a subject and a body. You can also use dynamic content that forwards information from PRTG such as Subject, Text, and Originator Address.
    Configure email message
    Click to enlarge.
  12. Click Save.

Option 2: Integration via the REST API

While the integration via email is quite straightforward because the corresponding actions already exist, for the integration via REST API, you have to take some preparatory steps.

Preparation

  1. Create a new REST API event source. For more information on how to do this, see https://www.derdack.com/portfolio_item/webhook-rest-api-mobile-app-text-push-voice-scheduling/.
  2. Create the PowerShell scripts with which Enterprise Alert can raise and, optionally, resolve alarms.

PowerShell script to raise an alert:

param( [string]$sensor, [string]$sensorid, [string]$date, [string]$status, [string]$message, [string]$device, [string]$since, [string]$lastup, [string]$sensorURL, [string]$deviceURL, [string]$serviceURL ) $body = ConvertTo-Json @{ Sensor = "$sensor" SensorID = "$sensorid" date = "$date" Status = "$status" Message = "$message" Device = "$device" Since = "$Since" Lastup = "$lastup" SensorURL = "$sensorURL" DeviceURL = "$deviceURL" ManagementURL = "$serviceURL" ExternalID ="$sensorid" } $uriEA9 = https:///EAWebService/rest/events?apiKey=<apiKey>" Invoke-RestMethod -Method POST -ContentType "application/json" -body "$body" -Uri "$uriEA9" exit 0;


Note: Replace <apiKey> with the according API key of the new REST API event source.


Optional: PowerShell script to resolve an alert:

param( [string]$sensor, [string]$sensorid, [string]$date, [string]$status, [string]$message, [string]$device, [string]$since, [string]$lastup, [string]$sensorURL, [string]$deviceURL, [string]$serviceURL ) $body = ConvertTo-Json @{ Sensor = "$sensor" SensorID = "$sensorid" date = "$date" Status = "$status" Message = "$message" Device = "$device" Since = "$Since" Lastup = "$lastup" SensorURL = "$sensorURL" DeviceURL = "$deviceURL" ManagementURL = "$serviceURL" ExternalID ="$sensorid" } $uriEA9 = https:///eawebservice/rest/events/$sensorid/reset?apiKey=<apiKey>" Invoke-RestMethod -Method POST -ContentType "application/json" -body "$body" -Uri "$uriEA9" exit 0;


Note: Replace <apiKey> with the according API key of the new REST API event source.

Optional: Configure Derdack Enterprise Alert

If you want to use the option to resolve an alert, you need to configure an external ID mapping.

  1. Log in to the Enterprise Alert portal and navigate to the REST endpoint.
  2. Map the ExternalID parameter to the ExternalID.
    Map ExternalID parameter
    Click to enlarge.

Configure PRTG

  1. Log in to the PRTG web interface.
  2. Select Setup | Account Settings | Notification Templates from the main menu.
  3. Hover over the plus button on the right side and click Add Notification Template.
    Add new notification template
    Click to enlarge.
  4. Enter a Template Name, for example, REST Enterprise Alert Notification.
    Name new notification template
    Click to enlarge.
  5. Scroll down to the notification methods and enable the method Execute Program. Then do the following:
    • As Executable File, select the PowerShell script that you previously created.
    • In the Parameter field, enter the following: -sensor '%sensor' -sensorID '%sensorid' -date '%date' -status '%status' -message '%message' -since '%since' -lastup '%lastup' -device '%device' -sensorURL '%linksensor' -deviceURL '%linkdevice' -serviceURL '%serviceurl' For more information about available placeholders, see also the PRTG Manual: List of Placeholders for Notifications.
    • Leave all other settings as they are and click Create.
      Configure notification method
      Click to enlarge.
  6. Optional: If you want to use the option to resolve an alert, repeat the previous steps and create a second notification template. As Executable File, select the PowerShell script that you created for an alert resolution.
  7. Navigate to the sensor that you want to create a notification for in case of an alarm.
  8. Select the Notification Triggers tab.
  9. Hover over the plus button on the right side and select Add State Trigger.
    Add notification trigger
    Click to enlarge.
  10. Configure the state trigger according to your needs. Make sure that you set the previously configured notification template REST Enterprise Alert Notification as the action for the first condition and, optionally, the notification template for the alert resolution as the action for the last condition.
    Configure notification trigger
    Click to enlarge.
  11. Click the blue check mark to save your settings.

More

Created on May 7, 2021 7:48:48 AM by  Maike Guba [Paessler Support]

Last change on May 26, 2021 5:22:05 AM by  Maike Guba [Paessler Support]



Please log in or register to enter your reply.


Disclaimer: The information in the Paessler Knowledge Base comes without warranty of any kind. Use at your own risk. Before applying any instructions please exercise proper system administrator housekeeping. You must make sure that a proper backup of all your data is available.