# 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](/features-guide/alert-watch/alert-sources.md) 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://oiadocs.cloudfabrix.io/integrations-guide/integrations/dynatrace.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
