(Deprecated) Integrating with Dynatrace

Dynatrace is a software intelligence platform based on artificial intelligence to monitor and optimize application performance and development, IT infrastructure, and user experience. As a tenant administrator, use BMC Helix Developer Tools to add, edit, and delete Dynatrace integrations.

The Dynatrace integration instances that were configured before the 22.1 release are now deprecated. A deprecated integration continues to work with 22.1. You can edit the integration. However, you cannot configure new instances of the integration. We recommend that you use BMC Helix Intelligent Integrations to configure new instances. For more information, see Integrating-with-Dynatrace.

Before you begin

The Dynatrace host must be accessible from your docker-enabled Linux server.

To edit a Dynatrace integration

From BMC Helix Developer Tools, open the Configured Integrations tab if the tab does not open by default.This tab shows deprecated Dynatrace integrations and all other configured integrations. The following example shows tile for a deprecated Dynatrace integration:

The tile shows the following information:
- The name of the integration with its build number.
- The incoming data. In this example, 5,046 CIs and 36 events have been received.
- The name of the user who modified the integration along with the time of the modification. In this example, it is the admin user.
- The connector status. In this example, the status is Active.
On the deprecated Dynatrace integration that you want to edit, select Edit from the Actions menu ().
Enter or edit the following source details:
- Integration Name: Provide a name for the integration.
- Select Connector: Select another connector if required.
- API URL: Enter the URL of the tenant.
  
  How do I obtain the API URL?
  
  Information
  To obtain this URL, in the Dynatrace console, select Settings > Public endpoints. You can see the URL as shown in the following image:
  
  The highlight text in the following image represents the API URL:
- Environment ID: Enter the Dynatrace environment ID.
  
  How do I obtain the environment ID?
  
  Information
  This is the host ID of the server where you have installed Dynatrace. For example, in the following image, the highlighted text in the following URL represents the environment ID:
- API-Token: Enter the Dynatrace API token.
  How do I generate the API token?
  In the Dynatrace console, generate an API token:
  Select SaaS-ops-services environment > Settings > Integration > Dynatrace API.
  Click Generate token.
  Copy the token.
  Warning
  Important
  You see this token only while you are generating it. Ensure that you copy it immediately. After you navigate away from this page, the token is not visible.
  For more information, see the Dynatrace documentation.

- Select entities to be registered: Select one or all of the available entities.
In the Customize Entity Configuration section, configure the advanced settings for the entities that you have selected in the previous step. You will see the Configure option for the selected entity types as shown below:

To configure the advanced settings, do the following steps:
1. Click Configure.
2. Based on the entity type selected, configure the following settings:
  - Event: Specify the refresh time for events in seconds. By default, the refresh time is set to 60 seconds.
  - CI: Specify the refresh time for CIs in hours. By default, the refresh time is set to 24 hours.
3. Click Save.
Click Update.
The Configured Integrations tab shows the updated integration.

To validate the Dynatrace integration

Ensure that the status of the integration is Connected. The following statuses are also valid:
- Configuring
- Disabled
- Disconnected
From BMC Helix Operations Management, go to Events to ensure that you can see the events in BMC Helix Operations Management.
For more information, see Event monitoring.
From BMC Helix Discovery, go to Explore > Data, and then click <count> Import Records in the Miscellaneous section to ensure that you can see the records from the source (host) in BMC Helix Discovery. Use these records further to create a business service model for the source depending on your use case requirements in BMC Helix AIOps. For more information, see Creating a model.

Dynatrace event class

The following event class is created in BMC Helix Operations Management to display the Dynatrace data:

DynatraceEvent
- Parent class name: EVENT
- Attributes

Dynatrace event slot mapping

The following table shows the event slot mapping between Dynatrace and BMC Helix Operations Management.

Frequently asked questions on the Dynatrace integration

This section provides answers to frequently asked questions.

Why can't I see all the entities in BMC Helix AIOps?

In BMC Helix AIOps, you can see only business services. To view all entities other than business services, go to the BMC Helix Discovery console. For example, to check the list of imported Configuration Items (CIs), do the following steps:

In the BMC Helix Discovery console, from the main menu, select Explore > Data.
The Infrastructure page opens. This page lists the total number of each type of infrastructure item in the system, as well as any infrastructure objects assigned to you. It also displays a list of infrastructure-related reports.
To view a list of CIs, under the Miscellaneous section, click <count> Import Records.
A list of CIs is displayed. For more information about how to search or filter these infrastructure items, see Managing your IT infrastructure.
Click any Dynatrace CI from the list to display the View Object page, which lists the attributes of the object and its relationships with other objects. For more information about the attribute mappings, see ImportRecord and for more information about steps to modeling the services, see Start anywhere application modeling.

Why do I see a difference between the number of entities available in the third-party solution and the number of entities fetched in BMC Helix AIOps?

After the specified time interval, BMC Helix AIOps fetches all CIs and event data from the third-party products, even if the data is already fetched in the previous cycle. Therefore, the CIs and events fetched in BMC Helix AIOps appear to be more than the number of CIs and events present in the third-party product. This situation causes no impact on performance.

Why are the Dynatrace events missing if the integration was disabled for more than three days?

By default, the BMC Helix Developer Tools collects the historical event data for the last three days (72 hours) only from Dynatrace. If you disable the Dynatrace integration and enable it after three days, the maximum historical event data collected is available only for the last three days. For example, If you disabled the integration on July 10th and enabled it on July 20th, you will see the historical data is from July 17th to July 20th only (for the last three days or 72 hours). Any historical event data before the last three days is not collected.

Why am I not seeing the host details for the services imported from Dynatrace?

The services imported from the Dynatrace metrics pipeline are not associated with their corresponding host details. Hence, the Dynatrace APIs do not provide the host data associated with the service to BMC Helix Developer Tools.