Monitor container resource usage of a Kubernetes cluster

go get



Heapster enables Container Cluster Monitoring.

Internally, heapster uses cAdvisor for compute resource usage metrics.

Heapster currently supports Kubernetes and CoreOS natively. It can be extended to support other cluster management solutions easily. While running in a Kube cluster, heapster collects compute resource usage of all pods and nodes.

Source configuration is documented here.

Running Heapster on Kubernetes

Heapster supports a pluggable storage backend. It supports InfluxDB with Grafana, Google Cloud Monitoring and Google Cloud Logging. We welcome patches that add additional storage backends.

To run Heapster on a Kubernetes cluster with,

Take a look at the storage schema here.

Running Heapster on CoreOS

Heapster communicates with the local fleet server to get cluster information. It expected cAdvisor to be running on all the nodes. Refer to this guide.

Running in other cluster management systems.

Heapster can be used to enable cluster-wide monitoring on other cluster management solutions by running a simple cluster-specific buddy container that will help Heapster with discovery of hosts.

Running in standalone mode.

It is also possible to run Heapster standalone on a host with cAdvisor using this guide.

Troubleshooting guide here


Contributions, questions, and comments are all welcomed and encouraged! Heapster and cAdvisor developers hang out in the #google-containers room on You can also reach us on the google-containers Google Groups mailing list.