You can use the Metrics API to periodically poll for data about your cluster, hosts, containers, and applications. The Metrics API is just one way to get metrics from DC/OS. It is designed for occasional targeted access to specific tasks and hosts. It is not the best way to get a comprehensive picture of all metrics on DC/OS. For this, please refer to the DataDog, Prometheus, and third-party plugins documents.
The Metrics API is backed by the DC/OS Metrics component, which runs on all nodes in the cluster.
For examples of how to use the Metrics API, see the Metrics Quick Start Guide.
Access to the Metrics API is proxied via Admin Router to each node. Statistics for the current leader are prefixed with:
Statistics for an agent are prefixed with:
To determine the URL of your cluster, see Cluster Access. The agent ID of a node is its Mesos ID.
The Metrics API request and response bodies are formatted in JSON.
Requests must include the accept header:
Responses will include the content type header:
All Metrics API routes require authentication to use.
The Metrics API also requires authorization via the following permissions:
All routes may also be reached by users with the
To assign permissions to your account, see the permissions reference.
The following resources are available under both of the above routes: