Agent Check Agent Check

Linux Mac OS Windows OS Supported


This integration gets container metrics from kubelet

  • Visualize and monitor kubelet stats
  • Be notified about kubelet failovers and events.



The Kubelet check is included in the Datadog Agent package, so you don’t need to install anything else on your servers.


Edit the kubelet.d/conf.yaml file, in the conf.d/ folder at the root of your Agent’s configuration directory, to point to your server and port, set tags to send along with metrics.


Run the Agent’s status subcommand and look for kubelet under the Checks section.


The kubelet check can run in two modes:

  • The default prometheus mode is compatible with Kubernetes version 1.7.6 or superior
  • The cAdvisor mode (enabled by setting the cadvisor_port option) should be compatible with versions 1.3 and up. Consistent tagging and filtering requires at least version 6.2 of the Agent.

OpenShift <3.7 support

The cAdvisor 4194 port is disabled by default on OpenShift. To enable it, you need to add the following lines to your node-config file:

  cadvisor-port: ["4194"]

If you cannot open the port, you can disable both sources of container metric collection, by setting:

  • cadvisor_port to 0
  • metrics_endpoint to ""

The check will still be able to collect:

  • kubelet health service checks
  • pod running/stopped metrics
  • pod limits and requests
  • node capacity metrics

Data Collected

Service Checks

Returns CRITICAL if the Kubelet doesn’t respond to Ping. OK, otherwise
Statuses: ok, critical

Returns CRITICAL if the Docker service doesn’t run on the Kubelet. OK, otherwise
Statuses: ok, critical

Returns CRITICAL if the syncloop health check is down. OK, otherwise
Statuses: ok, critical

Returns CRITICAL if the overall Kubelet health check is down. OK, otherwise
Statuses: ok, critical


Need help? Contact Datadog support.