Skip to content
This repository has been archived by the owner on Jan 11, 2023. It is now read-only.

Monitoring extension documentation addition #2740

Merged
merged 3 commits into from
Apr 20, 2018
Merged

Monitoring extension documentation addition #2740

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
635c2c0
add acs-engine monitoring extension section for monitoring docs
trstringer Apr 20, 2018
5032e77
add further post deployment experience documentation
trstringer Apr 20, 2018
3cc9267
fix monitoring extension doc suggested changes
trstringer Apr 20, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 15 additions & 4 deletions docs/kubernetes/monitoring.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,11 @@ Monitoring your Kubernetes cluster is important to be able to see your cluster's
There are five main options to monitor your cluster:

1. [Kubectl](#kubectl)
2. [Kubernetes dashboard](#kubernetes-dashboard)
3. [Grafana and Influx DB](#grafana-and-influx-db)
4. [Azure Operations Management Suite (OMS)](#oms)
5. [Heapster REST API](#heapster-rest-api)
1. [Kubernetes dashboard](#kubernetes-dashboard)
1. [Monitoring extension](#monitoring-extension)
1. [Grafana and Influx DB](#grafana-and-influx-db)
1. [Azure Operations Management Suite (OMS)](#oms)
1. [Heapster REST API](#heapster-rest-api)

## Intro to Heapster

Expand Down Expand Up @@ -65,6 +66,16 @@ Once you have opened the UI, you can explore node stats (CPU, Memory, etc...) un

![Image of Kuberentes dashboard](../images/k8s-monitoring-dashboard.png)

## Monitoring extension

A quick way to scaffold out cloud-native and open source monitoring components is to use the [acs-engine monitoring extension](https://github.com/Azure/acs-engine/tree/master/extensions/prometheus-grafana-k8s). For details on how to use the monitoring extension, please refer to the [extension documentation](https://github.com/Azure/acs-engine/tree/master/extensions/prometheus-grafana-k8s). By embedding the extension in your apimodel, the extension will do much of the work to create a monitoring solution in your cluster, which includes the following:

- [cAdvisor](https://github.com/google/cadvisor) daemon set to publish container metrics
- [Prometheus](https://prometheus.io/) for metrics collection and storage
- [Grafana](https://grafana.com/) for dashboard and visualizations

The extension wires up these components together. Post-deplyoment of the Kubernetes cluster, you just have to retrieve Grafana admin password (Kubernetes secret) and target your browser to the Grafana endpoint. There is already a pre-loaded Kubernetes cluster monitoring dashboard, so out-of-the-box you will have meaningful monitoring points with the extensibility that Prometheus and Grafana offer you.

## Grafana and Influx DB

Another option to see stats is via Grafana and Influx DB. Grafana is a powerful dashboarding tool that can be used to visualize all types of data from various sources. InfluxDB is a database that is used to store time series data. Heapster is responsible for aggregating metrics across your cluster and ingesting them into InfluxDB. Then Grafana uses InfluxDB as it's datasource to visualize metrics.
Expand Down