The metrics component provides metrics from DC/OS cluster hosts, containers running on those hosts, and from applications running on DC/OS that send StatsD metrics to the Mesos Metrics Module. The metrics component is natively integrated with DC/OS and is available per-host from the /system/v1/metrics/v0
HTTP API endpoint.
Overview
DC/OS provides these types of metrics:
- Host: metrics about the specific node which is part of the DC/OS cluster.
- Container: metrics about cgroup allocations from tasks running in the DC/OS Universal Container Runtime or Docker Engine runtime.
- Application: metrics about a specific application running inside the Universal Container Runtime.
The Metrics API exposes these areas.
All three metrics layers are aggregated by a collector which is shipped as part of the DC/OS distribution. This enables metrics to run on every host in the cluster. It is the main entry point to the metrics ecosystem, aggregating metrics sent to it by the Mesos Metrics module, or gathering host and container level metrics on the machine on which it runs.
The Mesos Metrics module is bundled with every agent in the cluster. This module enables applications running on top of DC/OS to publish metrics to the collector by exposing StatsD host and port environment variables inside every container. These metrics are appended with structured data such as agent-id
, framework-id
, and task-id
. DC/OS applications discover the endpoint via an environment variable (STATSD_UDP_HOST
or STATSD_UDP_PORT
). Applications leverage this StatsD interface to send custom profiling metrics to the system.
For more information on which metrics are collected, see the Metrics Reference.
Quick Start
Use this guide to get started with the DC/OS metrics component. The metrics component is natively integrated with DC/OS and no additional setup is required.…Read More
Metrics API
You can use the Metrics API to periodically poll for data about your cluster, hosts, containers, and applications. …Read More
Metrics Reference
Mesosphere DC/OS collects basic system metrics–such as CPU and memory–for nodes and containers automatically. Mesosphere DC/OS also collects metadata about the different categories of metrics. For more information about the metadata metrics, see Dimensions.…Read More
Sending DC/OS Metrics to Datadog
The Datadog metrics plugin supports sending metrics from the DC/OS metrics service directly to DatadogHQ. The plugin includes the function of the Datadog agent. You must install a plugin on each node in your cluster. This plugin works with DC/OS 1.9.4 and higher.…Read More
Sending DC/OS Metrics to Prometheus
The Prometheus metrics plugin supports sending metrics from the DC/OS metrics service to a Prometheus server. You must install a plugin on each node in your cluster.…Read More