Dynatrace integration with Virtana Platform
Dynatrace is an infrastructure monitoring platform that provides automated problem remediation and application performance management (APM). Virtana Platform and Dynatrace can be integrated to consolidate all your alerts in one place. You can connect the Virtana Platform and Dynatrace to see all your alerts in one place. This integration allows information to flow back and forth between both systems. You can either bring Dynatrace alerts into Virtana or send Virtana alerts into Dynatrace.
Setting up the integration starts by preparing your Dynatrace environment, where you configure the external requests allowlist and generate the required API tokens. Next, you configure the Virtana platform by entering the connection details and choosing the appropriate integration type, either Pull or Push. Finally, you verify the setup to ensure that alerts are successfully flowing between Dynatrace and Virtana as expected.
Prerequisites
Before configuring pull alerts in the Virtana Platform, ensure you have:
Admin access to both your Virtana Platform and Dynatrace environments.
Your Virtana Platform host domain information, for example,
<HOSTNAME>.virtana.com.
Setting up the Integration
To set up the integration, you must first perform preparation tasks within your Dynatrace environment to authorize connectivity and then configure the connection parameters within the Virtana Platform. This ensures a secure and seamless flow of alert data between the two systems based on your chosen alert direction (Push/Pull).
Prepare your Dynatrace Environment
To ensure security and connectivity, you must first authorize Virtana Global View within Dynatrace and generate an authentication token.
Add the Global View host in Dynatrace
Add the Virtana Global View host domain to your Dynatrace external requests allowlist to permit outgoing traffic. For detailed instructions, see the Dynatrace documentation on external requests.
Generate a Platform Token in Dynatrace for pull alerts
The pull alert integration requires a Platform Token with workflow-related scopes. Platform tokens are persistent access tokens that enable automated access to Dynatrace platform services. For detailed instructions, see the Platform tokens to generate your tokens.
Note
Select the Never expires checkbox while updating the fields in the Generate platform token page in Dynatrace. If the token expires, alerts will stop flowing into Global View, and the communication will completely stop.
In the Generate platform token page, under the Select token scopes section, search for workflow and select the following three scopes:
Scopes | Description |
|---|---|
| Grants permission to read workflows |
| Grants permission to write workflows |
| Grants permission to execute workflows |
Generate an Access Token in Dynatrace for pull alerts
The push alert integration requires an Access Token with the Ingest events scope. Access tokens authenticate API requests and control permissions, ensuring that only authorized services can access Dynatrace. For detailed instructions, see the Access tokens and permissions to generate your tokens.
Note
Leave the Expiration date field empty while updating the fields in the Generate access token page in Dynatrace. If the token expires, alerts will stop flowing from Global View to Dynatrace.
Configure Virtana Platform
You can configure the Virtana Platform to pull/push alert data from your Dynatrace environment automatically. By setting up this integration, you ensure that Dynatrace 'problem notifications' flow directly into your Virtana dashboard.
To configure this integration in Virtana Platform, perform the following steps:
Log in to the Virtana Platform and click Settings (
) in the top menu bar.Navigate to Integrations > Action Integrations to open the Action Integrations page.
In the Action Integration page, click Dynatrace.
The Update Integration panel slide opens.
In the Update Integration window, under the Connection Parameters section, specify your domain and token information, then select your action type (Pull/Push).
Pull Alerts: Select this option if you want the Virtana Global View to be your primary manager. It combines Dynatrace problems along with alerts from your containers, infrastructure, and services.
Push Alerts: Select this option if you prefer to use Dynatrace as your primary manager. Virtana will send its detected cost, capacity, and performance alerts directly to the Dynatrace Problems view.
Field
Description
Dynatrace Domain
Your Dynatrace instance domain in the format:
<instance-id>.apps.dynatrace.comAPI Token (for Action Type: Pull alerts)
The Dynatrace platform token.
API Token (for Action Type: Push alerts)
The Access Token was generated in Dynatrace.
If you select Action Type as Push Alert, enter the following details under the Filter Criteria section:
Field
Description
Alert Sources
Select the alert sources, such as IO, CO, SO, and CCM, to push to Dynatrace.
Severity
Select the severity levels of alerts, such as Critical, Major, Minor, Warning, Info, or Unknown, to push.
Click Save.
Once saved, whenever an alert in Global View matches the configured criteria (matching source and severity), it is automatically sent to the Dynatrace instance as a problem.
Verify the Integration
Once the connection is established, perform a final validation to ensure that data is successfully navigating the bridge between platforms. This step confirms that the authentication tokens are valid and that the alert filters are correctly routing data to your primary monitoring hub.
Verify the Pull Alert Configuration
Check your Dynatrace environment to ensure a new workflow appears with an Event trigger type.
In the Dynatrace navigation panel, click Workflows.
Confirm that a new workflow appears in the Workflows list with an Event trigger type.
Seeing this workflow means Virtana is now set up to receive alerts from Dynatrace.
View Pull Alerts in Global View
Once configured, Dynatrace problem notifications will automatically flow into the Virtana Platform.
Perform the following steps:
Log in to the Virtana Platform and navigate to Global View.
Click Alerts.
In the Source Type, select Dynatrace to filter alerts.
The dashboard shows the Dynatrace alerts, with details including the alert description, source type, and associated entity information.
View Pushed Alerts in Dynatrace
Alerts pushed from Global View to Dynatrace appear as problems in Dynatrace:
In the Dynatrace navigation panel, click Problems.
View the new problems that have been pushed from the Virtana Platform, including mapped property values from the original Global View alerts.
Note
In Dynatrace, alerts are referred to as problems. Dynatrace administrators can manage and act on these problems using standard Dynatrace workflows and tools.
Dynatrace Event Category Mappings in Global View
Dynatrace and Global View use different vocabularies to describe the impact of an event. Dynatrace classifies events by category (such as AVAILABILITY, ERROR, or PERFORMANCE), while Global View uses severity, priority, and display level to drive alerting, triage, and dashboard visibility. Without a well‑defined mapping between the two, operators would have no reliable way to know how a Dynatrace problem translates into a Global View alert that can lead to inconsistent triage, missed escalations, and noisy dashboards.
These mappings ensure that high‑impact Dynatrace events automatically surface in Global View as the most urgent and visible alerts, while lower‑impact events (such as informational or some custom alerts) are still captured without overwhelming dashboards.
Global View interpretation with the Dynatrace event
When Global View receives an event from Dynatrace, it uses the Dynatrace event category to derive the alert severity, priority, and alert display level. The following mappings are applied to ensure consistent triage and visibility.
Dynatrace Event Category | Global View Alert Severity | Global View Alert Priority | Global View Alert Display Level |
|---|---|---|---|
| Critical | High | N/A |
| Major | High | High |
| Minor | Medium | Medium |
| Warning | Low | Low |
| Info | N/A | N/A |
Push Alerts from Global View to Dynatrace
When Global View pushes an alert to Dynatrace as a problem, the event type sent is AVAILABILITY_EVENT. As a result, Dynatrace ingests the problem as an availability event. This ensures consistent triage and routing behaviors within Dynatrace for Global View-originated problems.