Get started with Opsgenie as a user
Learn how to configure your profile, get notifications from Opsgenie and view on-call schedules.
Integrate Opsgenie with PRTG
What does Opsgenie offer to PRTG users?
Opsgenie provides a powerful bidirectional integration with PRTG. When a sensor is down in PRTG, a corresponding Opsgenie alert is automatically created, containing detailed information. Opsgenie provides rich notifications with on-call rotations, scheduling features, and alert escalations to ensure the best monitoring management for PRTG customers. As users execute actions on the alerts acknowledged, the sensor information on PRTG is automatically updated according to mapped actions preferred by the customer.
Functionality of the integration
PRTG to Opsgenie:
When "sensor status down" notification is sent form PRTG, it creates an alert in Opsgenie.
When "sensor status up" notification is sent from PRTG, the related alert is closed in Opsgenie.
Opsgenie to PRTG:
If Send Alert Updates Back to PRTG is enabled, actions for PRTG are executed in PRTG when the chosen action is executed in Opsgenie for alerts which are created by the PRTG.
This action mapping feature is explained in detail in the Action Mapping Feature section.
Add PRTG integration in Opsgenie
You can add this integration from your team dashboard
If you're using Opsgenie's Free or Essentials plan, or if you’re using Opsgenie with Jira Service Management's Standard plan, you can only add this integration from your team dashboard as the Integrations page under Settings is not available in your plan.
Adding the integration from your team dashboard will make your team the owner of the integration. This means Opsgenie will assign the alerts received through this integration to your team only.
To do that,
Go to your team’s dashboard from Teams,
Select Integrations, and select Add integration.
Follow the rest of the steps to complete the integration.
Go to Settings > Integrations. Search for PRTG and select Add.
Copy the integration URL to use in PRTG configuration.
Select Save Integration.
Action Mapping Feature
Opsgenie allows customers to define action mappings between Opsgenie actions and PRTG actions.
To use the Action Mappings feature, provide the information listed below:
*Send Via OEC: Check to use on-premise PRTG
PRTG Username: API Username obtained from the account settings.
PRTG Passhash: API Passhash obtained from the account settings.
PRTG URL: The desired URL to use to visit your PRTG page.
For alerts created by PRTG
Use this section to map Opsgenie actions to a PRTG action when the source of the alert is PRTG (i.e When the alert is created by PRTG.)
Map different Opsgenie actions to different PRTG action. For example, to add "acknowledge a sensor" in PRTG, when the alert is acknowledged in Opsgenie. In order to do this, define If alert is acknowledged in Opsgenie, acknowledge sensor in PRTG mapping in Send Alert Updates Back to PRTG section.
Default Advance Filter Settings of PRTG integration in Opsgenie
Configuration on PRTG
In PRTG, go to "Setup -> Account Settings -> Notification Templates". Click Add new notification.
Select Execute HTTP Action.
Paste the URL copied previously into the "URL" field.
Select the Send SNI radio button and enter your instance's API URL in *Virtual Host (SNI).
US Region: api.opsgenie.com
EU Region api.eu.opsgenie.com
5. If you use PRTG version 16.x.24. and above paste the content of this text file, otherwise paste the content of this text file into "Postdata" field.
6. Click Save.
Integration via OEC (for On Premise PRTG Usage)
Use Opsgenie’s OEC and the PRTG script to update alerts on PRTG. This enables deployment of your own scripts/ability to modify the ones provided and execute customized actions on PRTG.
To use the PRTG integration package, follow the steps in the sections below through the end.
Download the latest version of OEC
To download the latest version of PRTG packages, please use readme file of oec-scripts repository.
Installation
For Red Hat Based Distributions
Run following command :
1
rpm -i opsgenie-prtg-<your_version>.rpmIf while installing the rpm package you get an error saying that the package is obsolated, you need to use "rpm -i opsgenie-prtg-1.0.4-rpm-x86-64.rpm --nodeps" instead.
If you get "is already installed" error, use "rpm -i opsgenie-prtg-1.0.4-rpm-x86-64.rpm --force" instead.
For Debian Based Distributions
Run following command : dpkg -i opsgenie-prtg-<your_version>.deb
For Windows
Unzip opsgenie integration zip file which contains OEC package into a directory (C:\opsgenie\oec is the preferred path.) Follow the instructions here to install OEC on Windows.
In order to learn more about how to run OEC you can refer to the Running OEC documentation.
Configuring PRTG Integration for OEC
In order to use OEC utility, enable Send Via OEC.
Other configurations regarding PRTG can be done either via integration page or OEC configuration file config.json. The configuration via the integration page precedes the configuration file.
OEC Configuration
Use Opsgenie’s OEC and the PRTG script to update alerts on PRTG.
To be able to execute actions in PRTG, OEC gets the configuration parameters from the configuration file. The configuration file can be found under /home/opsgenie/oec/conf/config.json.
Configuration parameters
apiKey – Copy the API key from the PRTG integration created above.
prtgUrl – PRTG with subdomain on it. Example: https://opsgenie.my-prtg.com
username – PRTG API Username under Account Settings at PRTG.
passhash – PRTG API Passhash under Account Settings at PRTG.
The package that you downloaded also includes OEC utility which is located under /usr/local/bin and the script that is needed to be run by OEC which is under /home/opsgenie/oec/scripts. After the configuration of OEC is done, you need to run it. In order to learn more about how to run OEC, you can refer to the Running OEC documentation.
Troubleshooting
Former PRTG Integration users can convert the integration to make it work for bidirectional use by adding sensorId, {{sensorId}} key-value pair to Extra Properties field at your PRTG Integration configuration.
If you are having trouble sending execute actions to OpsGenie, enable Send SNI and add opsgenie.com for US, eu.opsgenie.com for EU.
Was this helpful?