Ravi Srinivasan
2019-03-25 96d171175638b13537310ace4fc2a9e6145654d8
exercises/7-the-cluster-awakens/README.md
@@ -1,63 +1,48 @@
# Exercise Title
# The Cluster Awakens
> Short description of the exercise and it's outcomes
> In this exercise; we will monitor the core of the OpenShift Cluster. Watch for spikes in memory usage, hard disk space and other cluster stats.
![monitoring-mayhem](../images/exercise7/monitoring-mayhem.jpg)
_____
## Learning Outcomes
As a learner you will be able to
- Do thing 1
- Do thing 2
- Do thing 3
- View vital stats about the clusters health using Prometheus queries
- Visualise the data on Grafana dashboards
- Overlay log messages to the Grafana dashboards creating a very short feedback loop for Ops and Dev teams.
## Tools and Frameworks
> Name of tool - short description and link to docs or website
1. [Jenkins](https://jenkins.io/) - OpenSource build automation server; highly customisable through plugins
1. [Ansible]() - blah blah ...
1. [Prometheus](https://prometheus.io/) - Features Components Architecture When does it fit? When does it not fit? What is Prometheus? Prometheus is an open-source systems monitoring and alerting toolkit originally built at SoundCloud. Since its inception in 2012, many companies and organizations have adopted Prometheus, and the project has a very active developer and user community. It is now a standalone open source project and maintained independently of any company. To emphasize this, and to clarify the project's governance structure, Prometheus joined the Cloud Native Computing Foundation in 2016 as the second hosted project, after Kubernetes. For more elaborate overviews of Prometheus, see the resources linked from the media section.
1. [Grafana](https://grafana.com/) - The analytics platform for all your metrics Grafana allows you to query, visualize, alert on and understand your metrics no matter where they are stored. Create, explore, and share dashboards with your team and foster a data driven culture. Trusted and loved by the community.
## Big Picture
This exercise begins cluster containing blah blah
> From the previous exercise; we introduced app and jenkins monitoring. This exercise focuses on radiation of cluster statistics using Prometheus to scrape metrics and Grafana to display them.
![big-picture](../images/big-picture/big-picture-6.jpg)
_____
## 10,000 Ft View
> This should contain the goal of the exercise; with enough information that advanced learners could use this to build the exercise without much guidance. The information here
2. Highlevel instruction 1
2. Create a Grafana Dashboard to show key stats of the cluster such as memory usage, remaining disk space etc.
2. Highlevel instruction with ref to `file-a` to keep learners in supportable mode
2. Annotate the graphs by connecting the Elastic Search logs as a datasource in Grafana and running queries through it.
## Step by Step Instructions
> This is a fairly structured guide with references to exact filenames and sections of text to be added. Include pictures and code snippets where appropriate. Rule of thumb is learners are dumb.... so over describe _why_ we're doing things
### Part 1 - do some things
> _prefix of exercise and why we're doing it_
2. Do thing using tool X.
2. Insert blah into `file1.txt`
```
export SOME_THING=biscuits
```
2. Open console and navigate to `New Item` and click it ![new-item](./images/new-item.png)
### Part 2 - do some other things
> _prefix of exercise and why we're doing it_
3. Do other things
> This is a fairly structured guide with references to exact filenames and sections of text to be added. Include pictures and code snippets where appropriate. Over describe _why_ we're doing things
_____
## Extension Tasks
> _Ideas for go-getters. Advanced topic for doers to get on with if they finish early. These will usually not have a solution and are provided for additional scope._
 - Add Auth to your application
 - Do some other stuff
## Additional Reading
> List of links or other reading that might be of use / reference for the exercise
## Slide Links
- [Intro](https://docs.google.com/presentation/d/179Bz9GzHIcDxwb4RxxlQUESfqES4hArU1puGUjkAOoI/)
- [Wrap-up](https://docs.google.com/presentation/d/1n6f_A3i5019lZYmCBNhl9O-S3xxjpHDT5I7ZoCqYyHo/)
- [All Material](https://drive.google.com/drive/folders/13YIiKuzBmr9mGzg4bsEns5yVWx_Zc8Hs)
- [All Material](https://drive.google.com/drive/folders/13YIiKuzBmr9mGzg4bsEns5yVWx_Zc8Hs)