What are key requests?

Understand key requests

Certain web requests in your web-application environment likely warrant special attention, either because they're a critical measure of the success of your business (for example, a login request or a shopping-cart checkout request) or because they provide vital technical functionality that your application relies on. Dynatrace provides advanced monitoring functionality for such "key requests" so that you can monitor them with extra care.

Long-term trend data for key requests

Dynatrace enables you to chart any request that it detects during monitoring. By default, detailed history of all requests is retained for 14 days. Longer-term historical data is maintained for requests that you manually identify as key requests. Trend lines for key requests are retained perpetually, however the granularity of long-term history is gradually reduced over time:

  • First 14 days: Single-request granularity
  • 14-28 Days: 5-minute interval granularity
  • 28-400 days: 1-hour interval granularity
  • 400+ days: 1-day interval granularity


Select web requests that are pinned to your dashboard are automatically tagged as key requests.

To create a dashboard tile for a specific web request:

  1. Open the navigation menu and select Transactions & services.
  2. Select the relevant service from the list.
  3. On the service page, select a request from the right-hand side.
  4. Open the Browse (…) button and click Pin to home. A new request-specific tile that shows the most important metrics for that particular request is then added to your homepage dashboard.

API access

Timeseries and historical data of key requests can be retrieved via the Dynatrace Timeseries API endpoint. For details, see Dynatrace API documentation.

Custom alerting thresholds

Because certain requests may have specific response-time and failure-rate patterns, while others may have strict SLA thresholds, Dynatrace provides you with the ability to define custom alerting thresholds when anomalies are detected related to the performance of key requests.

Reduced alerting priority for low-volume requests

Dynatrace assumes that low-volume requests are of less importance than high-volume and key requests. This means that requests that contribute less than 1% to the overall load of a service won't raise alerts unless their impact is significant enough that the service's overall response time or failure rate is affected. Because this default treatment is not appropriate for all low-volume requests, you should manually tag any important low-volume requests as key requests to ensure that they have standard alerting thresholds.

Quick access to key requests

To make it easy to access key requests, each service's key requests are highlighted in a table on each Service page. This visibility is particularly valuable for low-volume, high-importance requests that might otherwise appear at the bottom of the Top requests table on each Service page.

Manually identify key requests

To tag a specific web request as a key request:

  1. Open the navigation menu and select Transactions & services.
  2. Select the relevant service from the list.
  3. On the service page, click Show all requests.
  4. Scroll down and select the request you want to edit.
  5. On the request page, click the Priority link to reset the priority from Normal to High.