• Products
  • Get started
  • Documentation
  • Resources

Integrate Opsgenie with Dynatrace AppMon

Dynatrace AppMonn logo

What does Opsgenie offer to Dynatrace AppMon users?

Opsgenie provides a powerful bidirectional integration with Dynatrace AppMon. When a new incident is created in Dynatrace AppMon, a corresponding Opsgenie alert is automatically created, containing rich information about the incident. Opsgenie provides rich notifications with on-call rotations, scheduling features, and alert escalations to ensure the best incident management for Dynatrace AppMon customers.

Functionality of the integration

  • When an incident is created in Dynatrace AppMon, it creates an alert in Opsgenie.

  • When an incident is closed in Dynatrace AppMonn, the related alert is closed in Opsgenie automatically.

  • If Send Alert Updates Back to Dynatrace AppMon is enabled, actions for Dynatrace AppMon is executed in Dynatrace AppMon when the chosen action is executed in OpsGenie for alerts which are created by the Dynatrace AppMon integration.

Add Dynatrace AppMon Integration in Opsgenie

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 add this integration from your team dashboard only. The Integrations page under Settings is not available in your plan.

  1. Go to Teams and select your team.

  2. Select Integrations on the left navigation and then select Add integration.

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. Follow the rest of the steps in this section to set up the integration.

  1. Go to Settings > Integrations. Search for Dynatrace AppMon and select Add.

  2. Specify who is notified of Dynatrace AppMon alerts using the Responders field. Autocomplete suggestions are provided as you type.

  3. Copy the integration URL to use during Dynatrace AppMon Plugin configuration.

  4. Select Save Integration.

Configuration in Dynatrace AppMon

  1. First, download the Opsgenie Dynatrace AppMon Plugin.

  2. Go to Dynatrace Client and select Manage Plugins from the Tools menu.

Dynatrace AppMon manage plugins

3. Then, click Install Plugin in the opening window.

Dynatrace AppMon configure plugins

4. Select Opsgenie Plugin JAR downloaded previously and click Open.

Dynatrace AppMon download plugin

5. Then, select Opsgenie Plugin from the listed plugins and click Properties.

Dynatrace AppMon plugin properties

6. Paste the integration URL copied previously to the Webhook URL field in the opening Plugin Properties window. This field is configured during Edit Incident Rule to use different integrations.

7. Enter the team names that exist in Opsgenie so that alerts can be created in Opsgenie for those specific teams only. This field can be kept empty and configured during Edit Incident Rule in order to assign different alerts to different teams in Opsgenie.

Dynatrace AppMon configure plugin properties

8. Click OK, then access Incidents from left side menu.

Dynatrace AppMon incident

9. From Incidents, select the incident to use for Opsgenie alerts and choose Edit Incident Rule from the dropdown menu.

Dynatrace AppMon edit incident rule

10. Click Advanced Configuration on the Actions tab.

Dynatrace AppMon advanced configuration actions tab

11. Then click Add.

Dynatrace AppMon edit incident rule

12. Select Dynatrace Opsgenie Plugin from the listed plugins and click AddFields in Properties part to be configured here in order to use different integration or assign alerts to different teams in Opsgenie.

Dynatrace AppMon add new rule action

13. Choose "on incident begin" as Execution option and click OK.

Dynatrace AppMon incident execution

Integration via OEC

Alternatively, use Opsgenie’s OEC and the Dynatrace AppMon script to execute actions on Dynatrace AppMon. This enables deployment of your own scripts/ability to modify the ones provided and execute customized actions on Dynatrace AppMon.

To use the Dynatrace AppMon integration package, follow the steps in the sections below through the end.

Download the latest version of OEC

To download the latest version of Dynatrace AppMon package, please use readme file of oec-scripts repository.

Installation

For Red Hat Based Distributions

  • Run following command : rpm -i opsgenie-dynatraceappmon-<your_version>.rpm

For Debian Based Distributions

  • Run following command : dpkg -i opsgenie-dynatraceappmon-<your_version>.deb

For Windows

  • Unzip opsgenie integration zip file which contains OEC package into a directory (C:\opsgenie\oec is the preferred path.)

For convenience lets refer to this Unzip path as %OEC_HOME%, you can create a system environment variable called OEC_HOME with the value of the unzip location, to do this open an elevated Powershell session and enter this command:

Text

1 [Environment]::SetEnvironmentVariable("OEC_HOME", <Path where you extracted OEC package>, 'Machine')

Configuring Dynatrace AppMon Integration for OEC

  • In order to use OEC utility, enable Send Via OEC.

  • Other configurations regarding Dynatrace AppMon can be done either via integration page or OEC configuration file config.json. The configuration via the integration page precedes the configuration file.

Dynatrace AppMon OEC

OEC Configuration

To be able to execute actions in Dynatrace AppMon, OEC gets the configuration parameters from the configuration file /home/opsgenie/oec/conf/config.json (Linux) or %OEC_HOME%\conf\config.json (Windows).

Configuration parameters

  • apiKey – Copy the API key from the Dynatrace AppMon integration created above.

  • userName – Dynatrace AppMon username.

  • password – Password for Dynatrace AppMon users.

  • url – Dynatrace AppMon url where actions are sent to (ex:https://localhost:8021).

  • profileName – The name of the corresponding System Profile.

The package that you downloaded also includes OEC utility which is located at path /usr/local/bin/OpsgenieEdgeConnector (Linux) or %OEC_HOME%\OpsgenieEdgeConnector.exe (Windows) and the script that is needed to be run by OEC which is under /home/opsgenie/oec/scripts/actionExecutor.py (Linux) or %OEC_HOME%\scripts\actionExecutor.py (Windows). 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.

Dynatrace AppMon Configurations

  1. Go to the Dynatrace Server and select Users from left menu.

Dynatrace Server

2. From the Users window, select the role of the user.

Dynatrace server users

3. Check the permissions of this user role and add Analyze Incidents, Manage Incidents and Web Service Interface Access if the user role doesn't have these.

Dynatrace server choose permissions

Sample parameters sent to OEC

JSON

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 { "type":"DynatraceAppMon", "alertId":"0e321daf-6532-4277-a61c-83d90dea9969", "customerId":"d17aae0e-7730-4788-bbd5-a306816287d3", "action":"Acknowledge", "mappedActionV2": { "name":"inProgressIncident", "extraField":"" }, "integrationId":"2bdcf8c9-a423-4efd-957c-07ee7de236ea", "integrationName":"Dynatrace AppMon", "integrationType":"DynatraceAppMon", "sendViaOEC":true, "profileName":"", "incidentRule":"", "userName":"", "password":"", "url":"", "state":"InProgress", "alias":"b324f7e2-c747-47bb-83d5-17b6a8eafaf8" }

 

Additional Help