Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Configure the integration in PRTG

Prerequisite

Jira Edge Connector (abbreviated as JEC) is a prerequisite for configuring the outgoing authentication of PRTG integration. Download the latest version of the PRTG package from this repository.

  1. In PRTG, go to Setup > Account Settings > Notification Templates.

  2. Select Add new notification > Execute HTTP Action.

  3. Paste the URL you copied while adding the integration in Jira Service Management into URL.

  4. Select Send SNI and enter the URL from Step 3 into the domain and subdomain fields of Virtual Host (SNI).

  5. Copy the POST data (from the file linked to, as applicable) and paste it into Postdata.

    1. For PRTG version 16.x.24. and above, use this post data.

    2. For other versions, use this post data.

  6. Select Save.

...

Authenticate via JEC (for on-premise PRTG)

Use Jira Edge Connector (abbreviated as JEC) is a prerequisite for configuring the outgoing authentication of PRTG integration. You can combinedly use JEC and the PRTG script scripts to update alerts on PRTG. With this setup, you can deploy your own script, modify the ones provided, or run customized actions on PRTG.

To use the PRTG integration package, complete the steps in the following section:

...

STEP 1. Download the latest version of PRTG packages and install the PRTG package from this repository.

2. Install the PRTG package:

Expand
titleInstructions for RedHat-based distributions

Run the following command : 

note
Code Block
rpm -i opsgeniejsm-prtg-<your_version>.rpm

If

while installing the rpm package you get an error saying

you figure that the rpm 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.

obsolete, run the following command instead:

Code Block
rpm -i jsm-prtg-<your_version>.rpm --nodeps

If you figure that the rpm package is already installed, run the following command instead:

Code Block
rpm -i jsm-prtg-<your_version>.rpm --force
Expand
titleInstructions for Debian-based distributions

Run the following command: 

Code Block
dpkg -i
opsgenie
 jsm-prtg-<your_version>.deb
Expand
titleInstructions for Windows
  1. Unzip Jira Service Management integration zip file

which
  1. (contains the JEC package) into a directory

(
  1. .
    For example: C:\jsm\oec

is the preferred path). Follow the instructions here to install JEC on Windows
  1. Install JEC by following these instructions.

Learn more about running JEC.

...

3. STEP 2: Configure the integration PRTG integration for JEC

...

  1. In Jira Service Management, go to the integration configuration page.

  2. Expand the Outgoing section.

...

To use the JEC utility, select Send Via JEC.

  1. Select the Authenticate with Jira Edge Connector only check box.

You can make the other configuration through the integration configuration page or the JEC configuration file, config.json. The configuration

...

set through the integration

...

4. Configure JEC.configuration page takes precedence over what’s in config.json.

...

STEP 3: Configure JEC

Use JEC and the PRTG script to update alerts on PRTG. To run actions in PRTG, JEC gets the configuration parameters from the configuration file. The configuration file can be found under , config.json (found at /home/opsgeniejsm/oecjec/conf/config.json).

Configuration parameters

  • apiKeyCopy the The API key from you copied while adding the PRTG integration created above.integration in Jira Service Management

  • prtgUrlThe PRTG URL with a subdomain on in it. Example: https https://jsm.my-prtg.com

  • usernameThe PRTG API Username username under Account Settings at in PRTG.

  • passhashThe PRTG API Passhash passhash under Account Settings at in PRTG.

The downloaded package that you downloaded also includes the JEC utility which is located under (found in /usr/local/bin) and the script that is needed JEC needs to be run by JEC which is under run (found in /home/opsgenie/oec/scripts. After the configuration of JEC is done, you need to run it. To learn more about how to run JEC, you can refer to the Running JEC documentation.

Troubleshooting

...

). Be sure to run JEC after configuring it.

Learn more about running JEC documentation.

...

Troubleshoot issues

  • If you have an older setup of the integration and want to make it work bidirectionally, add sensorId, {{sensorId}} key-value pair to

...

  • alert properties in your PRTG Integration configuration.

  • If you are having trouble sending execute actions to Jira Service Management, enable Send SNI

...

  • .