k3s/cluster/addons/cluster-monitoring/README.md

# Kubernetes Monitoring

[Heapster](https://github.com/kubernetes/heapster) enables monitoring and performance analysis in Kubernetes Clusters.
Heapster collects signals from kubelets and the api server, processes them, and exports them via REST APIs or to a configurable timeseries storage backend.

More details can be found in [Monitoring user guide](http://kubernetes.io/docs/user-guide/monitoring/).

## Troubleshooting

Heapster supports up to 30 pods per cluster node. In clusters where there are more running pods, Heapster may be throttled or fail with OOM error. Starting with Kubernetes 1.9.2, Heapster resource requirements may be overwritten manually. [Learn more about Addon Resizer configuration](https://github.com/kubernetes/autoscaler/tree/master/addon-resizer#addon-resizer-configuration)

### Important notices

Decreasing resource requirements for cluster addons may cause system instability. The effects may include (but are not limited to):
  - Metrics not being exported
  - Horizontal Pod Autoscaler not working
  - `kubectl top` not working

Overwritten configuration persists through cluster updates, therefore may cause all effects above after a cluster update.

[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/cluster/addons/cluster-monitoring/README.md?pixel)]()
Upgraded heapster to v0.18.1, influxDB to v0.8.9, and Grafana to v2.0. 2015-09-18 23:19:46 +00:00			`# Kubernetes Monitoring`
Use Heapster as an in-built monitoring solution for Kubernetes in GCE. Users will have an option to enable it when they setup their cluster (kube-up). 2014-11-06 19:35:33 +00:00
Updated documentation about monitoring addons 2016-03-16 09:10:17 +00:00			`[Heapster](https://github.com/kubernetes/heapster) enables monitoring and performance analysis in Kubernetes Clusters.`
Upgraded heapster to v0.18.1, influxDB to v0.8.9, and Grafana to v2.0. 2015-09-18 23:19:46 +00:00			`Heapster collects signals from kubelets and the api server, processes them, and exports them via REST APIs or to a configurable timeseries storage backend.`

Updated documentation about monitoring addons 2016-03-16 09:10:17 +00:00			`More details can be found in [Monitoring user guide](http://kubernetes.io/docs/user-guide/monitoring/).`
Add ga-beacon analytics to gendocs scripts hack/run-gendocs.sh puts ga-beacon analytics link into all md files, hack/verify-gendocs.sh verifies presence of link. 2015-05-14 22:12:45 +00:00
Add Troubleshooting sections to Heapster and Metrics Server addons documentation 2018-03-05 14:37:41 +00:00			`## Troubleshooting`

			`Heapster supports up to 30 pods per cluster node. In clusters where there are more running pods, Heapster may be throttled or fail with OOM error. Starting with Kubernetes 1.9.2, Heapster resource requirements may be overwritten manually. [Learn more about Addon Resizer configuration](https://github.com/kubernetes/autoscaler/tree/master/addon-resizer#addon-resizer-configuration)`

			`### Important notices`

			`Decreasing resource requirements for cluster addons may cause system instability. The effects may include (but are not limited to):`
			`- Metrics not being exported`
			`- Horizontal Pod Autoscaler not working`
			- `kubectl top` not working

			`Overwritten configuration persists through cluster updates, therefore may cause all effects above after a cluster update.`

Add ga-beacon analytics to gendocs scripts hack/run-gendocs.sh puts ga-beacon analytics link into all md files, hack/verify-gendocs.sh verifies presence of link. 2015-05-14 22:12:45 +00:00			`[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/cluster/addons/cluster-monitoring/README.md?pixel)]()`