Managing deprecated Dynatrace integrations

As a tenant administrator, perform the following steps to edit and validate the integrations configured with Dynatrace. 

Before you begin

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

To edit a Dynatrace integration

1. 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 the 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.
2. On the deprecated Dynatrace integration that you want to edit, select Edit from the actions menu .
3. Optionally, edit the following source details:
   • Integration name

   • API URL

     How do I obtain the API URL?

     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:
     
     

   • Dynatraceenvironment ID

     How do I obtain the environment ID?

     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:

     

   • DynatraceAPI token

     How do I generate the API token?

     In the Dynatrace  console, generate an API token:

     1. Select SaaS-ops-services environment > Settings > Integration > Dynatrace API.
     2. Click Generate token.

     3. Copy the token.

        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.

   • Entity types (Events and CIs) to import
4. In the Customize Entity Configuration section, click Configure  and edit the following advanced settings for the entities that you have selected in the previous step:
   • Events: Specify the refresh time for events in seconds. By default, the refresh time is set to 60 seconds.
   • CIs:  Specify the refresh time for CIs in hours. By default, the refresh time is set to 24 hours.
5. Click Update. 
   On the Configured Integrations  tab, the status of the integration changes to CONFIGURING. After the integration is configured completely, the status changes to CONNECTED.

To validate the Dynatrace integration

• Ensure that the status of the integration is CONNECTED.

• 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 Monitoring and managing events.

• 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 Managing models.

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

    Name	Data type
    affectedRequestsPerMinute	INTEGER
    artifact	STRING
    entityName	STRING
    sourceEventId	STRING
    sourceTags	STRING
    eventType	STRING
    impactLevel	STRING
    percentile	STRING
    severityLevel	STRING
    source	STRING
    annotationType	STRING
    annotationDescription	STRING
    correlationId	STRING
    serviceMethodGroup	STRING
    serviceMethod	STRING
    syntheticErrorType	STRING
    affectedSyntheticActions	STRING
    affectedSyntheticLocations	STRING

Dynatrace event slot mappings

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