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

If you do not see the Settings page you're looking for in the sidebar, 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.*"

SLOs

Similarly, SLO IDs can be found in the URL of a selected SLO in the Dynatrace portal under the id query param. Navigate to the SLO panel, then click on the Actions dropdown & View in Data Explorer to get the correct URL. For example, https://{environment-id}.live.dynatrace.com/ui/data-explorer?gtf=-1w&gf=all&refId={sloId}

x-cortex-slos:
  dynatrace:
    - id: mock-slo-id-1
    - id: mock-slo-id-2

Dependencies

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