# Dynatrace

## Prerequisites: <a href="#prerequisites" id="prerequisites"></a>

The following are pre-requisites for creating Dynatrace as a Datasource. It is used for Alert Notifications from Dynatrace and collecting Host/Application Configuration and Metrics & Logs on-demand.

1\) Dynatrace SaaS Account

2\) An API Key (Created on Dynatrace SaaS portal)

3\) One or more Hosts or Applications or Databases being monitored by Dynatrace

## Enabling API access on Dynatrace SaaS portal: <a href="#enabling-api-access-on-appdynamics-saas-controller" id="enabling-api-access-on-appdynamics-saas-controller"></a>

**Step 1:** Login to https\://\<instance-name>.live.dynatrace.com using your credentials

**Step 2:** Go to ‘Settings’ → ‘Integration’ → ‘Dynatrace API’

![](https://gblobscdn.gitbook.com/assets%2F-LhoMVYxiQlKXh6OxX98%2F-M0e9lfEbb3zRargMDxJ%2F-M0eA4i39pJg0la-JQB1%2FScreen%20Shot%202020-02-21%20at%203.51.42%20PM.png?alt=media\&token=6f312470-f9f8-47a2-9b11-a563293705ad)

**Step 3:** Click on ‘Generate Token’, Enter a Name under ‘Token name’

![](https://gblobscdn.gitbook.com/assets%2F-LhoMVYxiQlKXh6OxX98%2F-M0e9lfEbb3zRargMDxJ%2F-M0eBAPl3wg6MCfyw-g3%2Fimage.png?alt=media\&token=a67a917a-4a36-4405-a0be-c0f7135ff706)

**Step 4:** Enable below permissions for the API access

* Access problem and event feed, metrics, and topology
* Read log contents
* Read synthetic monitors, location and nodes
* Read configuration
* Log import
* Read audit logs

## **Configure Dynatrace Alert Notifications using Webhook:** <a href="#configure-dynatrace-alert-notifications-using-webhook" id="configure-dynatrace-alert-notifications-using-webhook"></a>

**Prerequisites:** Click here for [Alert Sources](https://oiadocs.cloudfabrix.io/features-guide/alert-watch/alert-sources) to create a Webhook URL for Dynatrace alert notifications in CloudFabrix AIOps platform.

**Step 1:** Login to https\://\<instance-name>.live.dynatrace.com using your credentials

**Step 2:** Go to ‘Settings’ → ‘Integration’ → ‘Problem notifications’

**Step 3:** Click on ‘Setup notifications’

**Step 4:** Click on ‘Custom Integration’ (Webhook)

**Step 5:** Enter the ‘Webhook Name’

**Step 6:** Copy & Paste the Webhook URL that was generated for Dynatrace alerts under OIA Administration in the previous section

**Step 7:** Select ‘Accept any SSL certificate’ option “ONLY” if you want to ignore self-signed certificate warning. (Caution: It is highly recommended to install CA signed certificate on cfxDimensions platform and do not select this option for security reasons)

**Step 8:** Click on ‘Create basic authorization header’ to add Username & Password for the Webhook (Please refer previous section)

**Step 9:** Under ‘Custom Payload’, Enter the below Alert fields.

```
{
"ImpactedEntity":"{ImpactedEntity}",
"EntityID":"{PID}",
"State":"{State}",
"Details":{ProblemDetailsJSON},
"DetailedText":"{ProblemDetailsText}",
"ProblemID":"{ProblemID}",
"ProblemTitle":"{ProblemTitle}",
"Severity":"{ProblemSeverity}",
"ImpactType":"{ProblemImpact}",
"URL":"{ProblemURL}",
"Tags":"{Tags}"
}
```

**Step 10:** Select ‘Alerting Profile’

**Step 11:** Click on ‘Send test notification’ to verify it is able to send a ‘Test Alert’ successfully to cfxDimensions platform.

**Step 12:** Click on ‘Save’ to commit the Webhook notification settings.