Skip to main content

Dynatrace

CatalogDiscoveryScorecards

Summary​

Dynatrace is an observability platform that can provide insights into the following:

  • Application performance
  • Service discovery
  • SLOs
  • Dependencies

Setup​

In order to connect Cortex to your Dynatrace instance, you’ll need to add an access token and the Dynatrace URL necessary to access your environment depending on whether you employ a managed, SaaS, or Environment ActiveGate version of the service. The configuration is located under Settings → Dynatrace.

The token will need the following scopes: Read entities and Read SLO

caution

If you do not see the settings page you're looking for, you likely don't have the proper permissions and need to contact your admin.

Registration​

APM​

Entity ID​

Entities with a type of "SERVICE" will be discovered and surfaced. When using the Dynatrace portal, service IDs can be found in the URL of a selected service under the id query param. For example, https://{environment-id}.live.dynatrace.com/#newservices/serviceOverview;id={service-id}

x-cortex-apm:
  dynatrace:
    entityIds:
      - mock-service-id-1
      - mock-service-id-2

Entity name​

You can also match entities based on matching display names with a regular expression, like:

x-cortex-apm:
  dynatrace:
    entityNameMatchers:
      - "foo.*"

Linking SLOs in Cortex​

Dynatrace supports service-level objective (SLO) monitoring. You can link these SLOs to your Dynatrace entity in Cortex:

  1. In Dynatrace, navigate to the Service-Level Objectives app.
    • On the left sidebar of Dynatrace, click Search, then type in slo to find the app.
  2. On the SLOs page, see the list of SLOs. On the right side of an SLO, click ^ to expand the Details. The details button is on the right side of an SLO
  3. In your browser's URL bar, locate the ID in the URL. Copy the ID and store it in a secure location, as you will need this value in the next steps.
    • The ID is displayed in the URL following sloexp=. For example, https://{environment-id}.apps.dynatrace.com/ui/.../sloexp={ slo-Id }&slovis= The SLO ID is in the URL
    • On the SLOs page, expand the details for each SLO to display the SLO ID in the URL.
  4. Open your Cortex home page, then navigate to the service you are configuring.
  5. In the upper right corner of the service page, click Switch to YAML.
  6. Paste in the following text, making sure to replace slo-id-1 and slo-id-2 with the SLO IDs you obtained from the Dynatrace URL in the previous steps:
x-cortex-slos:
  dynatrace:
    - id: slo-id-1
    - id: slo-id-2
  1. At the bottom of the page, click Save.

After saving, navigate back to your service details page to view the SLO status in the service's Overview tab.

For information on working with SLOs in Dynatrace, see Dynatrace's documentation.

Dependencies​

Cortex automatically syncs dependencies from Dynatrace using attributes inherent to each entity.