# Dynatrace

### What is Dynatrace integration in ZigiOps?

Dynatrace is a software intelligence and observability platform that provides monitoring for applications, infrastructure, user experience, and cloud environments.

ZigiOps enables secure, agentless integration between Dynatrace and ITOM, ITSM, and monitoring platforms. Using ZigiOps, Dynatrace problems, metrics, events, and topology data can be synchronized with downstream systems to support centralized monitoring, event correlation, and automated incident workflows.

With ZigiOps, Dynatrace can:

* Forward problems and events to event management and ITSM systems
* Synchronize metrics with centralized monitoring platforms
* Share application and host topology data
* Support both polling-based and listener (webhook) integrations

### Which Dynatrace versions are supported?

Using a supported version is mandatory.

| Product   | Supported Deployment Types | Supported Versions |
| --------- | -------------------------- | ------------------ |
| Dynatrace | Managed, SaaS              | All                |

### Are there any environmental prerequisites for Dynatrace?

{% hint style="info" %}
Confirm the prerequisites of the corresponding integration template before continuing, as some templates may not require all environmental prerequisites.
{% endhint %}

See the **Related Templates** section at the end of this page.

### How do I generate an API Token in Dynatrace?

An API token is required to authenticate Dynatrace with ZigiOps.

{% stepper %}
{% step %}
Log in and open the API token settings

Log in to your Dynatrace instance and navigate to **Settings > Integration > Dynatrace API**.
{% endstep %}

{% step %}
Generate and configure the token

Click **Generate Token** and configure the following:

**Display Name**\
Enter a meaningful name for the token.

**Permissions**

Enable the following permissions:

*API v1:*

* Access problem and event feed, metrics, and topology

*API v2:*

* Read entities
* Read metrics
* Read problems
  {% endstep %}

{% step %}
Generate and save the token

Click **Generate**, then copy the generated token and store it securely.

{% hint style="warning" %}
The token is visible only once at creation time and cannot be retrieved later.
{% endhint %}
{% endstep %}
{% endstepper %}

### How do I create a Webhook Problem Notification in Dynatrace?

Webhook notifications are required for listener-based integrations where Dynatrace pushes problems directly to ZigiOps.

{% stepper %}
{% step %}
Open Problem Notifications

Log in to your Dynatrace instance and navigate to **Settings > Integration > Problem Notifications**.
{% endstep %}

{% step %}
Add a custom integration notification

Click **Add Notification** and select **Custom Integration** and configure:

**Display Name**\
Freeform name shown in Dynatrace.

**Webhook URL**\
Target URL of the ZigiOps listener for the **Receive Problems** action.

Example: `http://zigiops.example.com:9094/listener/dynatracesaas/problem`

If the ZigiOps listener uses HTTPS, you must enable **Accept any SSL certificate (Self-signed or invalid)**.

**Custom Payload**\
This payload is sent via HTTP POST when a problem is detected or resolved. The payload below is mandatory:

```json
{
  "problem_title": "{ProblemTitle}",
  "problem_details": "{ProblemDetailsText}",
  "status": "{State}",
  "severitylevel": "{ProblemSeverity}",
  "impactlevel": "{ProblemImpact}",
  "rankedimpacts": {ImpactedEntities},
  "tagsofaffectedentities": "{Tags}",
  "problem_url": "{ProblemURL}",
  "id": "{PID}"
}
```

{% endstep %}

{% step %}
Enable and test the notification

Enable the **Receive Problems** action in ZigiOps, then click **Send Test Notification** to validate connectivity.

Click **Save**.
{% endstep %}
{% endstepper %}

### How do I connect Dynatrace to ZigiOps?

#### Dynatrace - Connected System Configuration

Follow the steps below to add Dynatrace as a connected system in ZigiOps.

{% stepper %}
{% step %}
Open the connected system setup

Log in to your **ZigiOps** instance and navigate to **Connected Systems > Add New System > Dynatrace**.
{% endstep %}

{% step %}
Configure the system

Configure the following parameters:

**Server URL**\
URL of your Dynatrace environment.

Examples:

* `https://{your-environment-id}.live.dynatrace.com`
* `https://{your-domain}/e/{your-environment-id}`

**API Token**\
Enter the API token generated earlier.

**Proxy Settings (optional)**\
Enable this option if a proxy server is required.
{% endstep %}

{% step %}
Save the connected system

Review the configuration, then click **Save** to store the connected system.

Once saved, Dynatrace becomes available for use in ZigiOps integration templates.
{% endstep %}
{% endstepper %}

### What are the most common Dynatrace integration use cases?

#### Use case 1: Sending Dynatrace problems to event management systems

Dynatrace problems can be forwarded to event management platforms such as OBM, enabling centralized event correlation and faster incident response.

#### Use case 2: Synchronizing Dynatrace metrics

Dynatrace metrics can be synchronized with centralized monitoring systems, providing unified visibility across infrastructure and applications.

#### Use case 3: Topology synchronization and enrichment

Dynatrace application and host topology can be synchronized to downstream systems, enriching topology models and supporting root-cause analysis workflows.

### What integration templates are available for Dynatrace?

ZigiOps provides multiple prebuilt integration templates for Dynatrace.

#### Related Templates

* Dynatrace application topology - OBM topology
* Dynatrace application topology - vROps topology
* Dynatrace host topology - OBM topology
* Dynatrace listener problems - OBM events
* Dynatrace polling problems - OBM events
* Dynatrace metrics - OBM metrics

Each template includes:

* Predefined entity mappings
* Direction of synchronization (polling or listener-based)
* Entity-specific logic and filters

### Summary

The Dynatrace integration in ZigiOps enables:

* Secure, agentless connectivity to Dynatrace (Managed and SaaS)
* Support for all Dynatrace versions
* API token-based authentication
* Webhook-based and polling-based integrations
* Ready-to-use templates for problems, metrics, and topology synchronization


---

# 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://docs.zigiwave.com/available-systems/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.