Issue-tracking integration

To get statistics for your monitored entities about release issues and configure dynamic queries, you can integrate your issue-tracking system with Dynatrace.

Supported integrations

Dynatrace currently supports integration with

  • Jira (on-premises and cloud)
  • GitHub
  • GitLab
  • ServiceNow

Integrate your issue-tracking system

To integrate your issue-tracking system

  1. In Dynatrace, go to Releases and select Configure in the Tracked issues section.
  2. On the Issue-tracking queries for release monitoring page, select Add issue-tracking query.
  3. Enter the information required (Issue label, Issue query, Issue type, Issue-tracking system, Target URL, Username, and Password or Token).
  4. optional Select Test connection to check connectivity between Dynatrace and the issue-tracking system.
  5. Select Save changes to save your configuration.

Issue query

In the Issue query field, you can specify queries with placeholders that are resolved at runtime (for dynamic filtering).
Examples:

  • Jira/Jira cloud: issueType = Bug and component in ({PRODUCT}) and affectedVersion in ({VERSION})
  • GitHub: is:issue is:open label:{PRODUCT} label:{VERSION}
  • GitLab: search={PRODUCT} {VERSION}&state=opened&scope=issues

Exception

For ServiceNow, placeholders aren't supported. You can query incidents by incident attribute values using the format <col_name><operator><value>.
Example: correlation_displayLIKEDYNATRACE^active=true. In this case, filtering will apply for records that contain DYNATRACE within the correlation_display column and that are currently active.
For other operators, consult the ServiceNow API documentation.
Note: Any query that can be written as a sysparm_query request parameter is supported.

Credentials

The Username, Password, and Token fields are required as follows:

  • For GitHub, enter a username and an OAuthToken
  • For GitLab, enter an API token with read permissions
  • For Jira, enter a username and a password
  • For Jira cloud, enter a username and an OAuthToken
  • For ServiceNow, enter a username and a password

Once you add your issue tracker to Dynatrace, you can see issue statistics related to the monitored entities in the Release inventory on the Releases page. For example, if the release inventory shows entries for the application Cassandra with version 3.11, the issue-tracking integration will provide the count of bugs for Cassandra version 3.11.

Limitations

You can create a maximum of 20 issue-tracking configurations.

Troubleshooting