Upgrade from Metrics Classic to Metrics on Grail
- Latest Dynatrace
- Overview
- 2-min read
Metrics on Grail replace Metrics Classic as the foundation for analyzing observability data in Dynatrace. Metrics on Grail are queried with DQL, while classic metrics use metric selectors. Upgrading your queries lets you use the full power of Grail in 
Notebooks, 
Dashboards, and other Dynatrace apps.
Most classic metrics have a direct Grail equivalent. Some metrics are convergent, meaning a single Grail-based metric covers multiple classic metrics, with dimensions and filters used to reach the same level of detail. Others are unsupported, which means no Grail equivalent exists yet, but DQL queries against spans or other data can often approximate them. To check whether a specific classic metric is supported on Grail and find its Grail key, see Built-in Metrics on Grail. Dedicated upgrade guides cover the mapping patterns and DQL examples for each metric type.
Use the guides below to upgrade your metric queries by type.
- Upgrade guide
- Use the automatic metric selector converter to convert your Classic metric selectors to DQL and upgrade several queries at once.
- Upgrade guide
- Convert your classic service metric selectors to DQL using this guide, which covers convergent and unsupported metric mappings.
- Upgrade guide
- Convert your Classic technology metric selectors to DQL by following this step-by-step runtime metrics upgrade guide.
- Upgrade guide
- Convert your Classic calculated service metrics to DQL for continued application performance monitoring.
- Upgrade guide
- Convert your Classic Kubernetes metrics to DQL by mapping Classic metric selectors to DQL equivalents.
- Upgrade guide
- Map your Classic RUM metric keys to their logical Grail equivalents and convert your RUM metric queries from Metrics Classic to Grail.