Cluster information API

The Cluster information API enables you to check the version and internal time of your Dynatrace environment.

GET cluster time

The request produces plain/text.

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

The response in cluster time in UTC milliseconds.

GET cluster version

Dynatrace innovates fast and releases a new server(cluster) version with new features every two weeks.

We operate multiple SaaS clusters worldwide and those clusters are updated at different times. As this update process is completely transparent for our customer it is hard to exactly identify when your environment is updated to a new cluster version.

This API endpoint enables you to query the actual cluster version of your environment.

The request produces an application/json payload.

GET
  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/config/clusterversion
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v1/config/clusterversion
  • Environment ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/v1/config/clusterversion

Authentication

To execute this request, you need the Access problem and event feed, metrics, and topology (DataExport) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.

Response

Response codes

Code Description
200

Success

Response body

The ClusterVersion object

Element Type Description
version string

The version of the Dynatrace server.