• Home
  • Dynatrace API
  • Environment
  • Cluster information

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.

GETManaged 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.

GETManaged 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 an access token with Access problem and event feed, metrics, and topology (DataExport) scope. To learn how to obtain and use it, see Tokens and authentication.

Response

Response codes

CodeTypeDescription
200ClusterVersion

Success

Response body objects

The ClusterVersion object

ElementTypeDescription
versionstring

The version of the Dynatrace server.

Can be null.

Response body JSON model

json
{ "version": "string" }