How do I fetch the metrics of monitored entities?

The timeseries endpoint delivers metrics that Dynatrace collects from the different monitored entities over time. This endpoint is used to read metrics, such as CPU usage, for selected entities over a given timeframe. By passing additional parameters it allows you to filter the selected timeseries for entity types and to specify what type of result aggregation the result should contain.

GET timeseries

Lists all metric definitions, along with parameters of each metric, available within your environment, which matches specified parameters. If no parameters are specified, the call will list all the defined and exposed metrics.

The request produces application/json payload.

GET
  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/timeseries
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v1/timeseries

GET data points of timeseries

Fetches parameters of the specified timeseries and, optionally, its data points.

To obtain data points, set the includeData parameter to true. You must also specify the timeframe, either as the relative time or as a combination of start and end timestamps. You must also provide the aggregation type supported by the requested metric.

You can obtain either data points or the scalar result of the specified timeseries, depending on the queryMode.

The request produces application/json payload.

GET
  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/timeseries/{timeseriesId}
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v1/timeseries/{timeseriesId}

POST data points timeseries

Provides advanced filtering possibilities, comparing to GET request. Lists all available metric data points, matching specified parameters.

The request consumes and produces application/json payload.

POST
  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/timeseries/{timeseriesId}
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v1/timeseries/{timeseriesId}

Process types

The list of known process types we monitor with Dynatrace is continuously growing. If you don't see a certain process type in the list below, please refer to the Dynatrace processes page and see if the process is included there.

OS types

The list of known operating systems that we monitor with Dynatrace is continuously growing. If you don't see a certain OS type listed below, please refer to the Dynatrace hosts page and see if the OS type is included there.

Service types

Technology types

Aggregation types

Available timeseries

Built-in timeseries

Plugin timeseries