zwkee / prometheus-grafana-learning Goto Github PK

Prometheus Grafana Learning

An experimental setup for learning Prometheus & Grafana.

Report Bug · Request Feature

Prometheus and Grafana are two popular open-source infrastructure monitoring tools used in the DevOps world. This project aims to provide a minimal setup of both tools in a single node Kubernetes environment for self-exploration and learning purposes. More applications can be added to the cluster to explore different metrics and visualization.

Refer to the section below on some of the tools used to setup the local environment. Vagrant and VirtualBox may not be required if the setup is expected to run on the host machine, but that will require Ansible to be installed and manually running the playbooks to spin up the Prometheus and Grafana resources in Kubernetes.

(back to top)

As mentioned in the introduction, there are a couple of tools required for the local development. Please install the tools below before proceeding with the setup.

• Vagrant
• VirtualBox

1. Clone the repository

   git clone https://github.com/keezw/prometheus-grafana-learning.git

2. Change working directory

   cd prometheus-grafana-learning

3. Spin up virtual machines that will automatically install Prometheus and Grafana

   vagrant up

4. SSH into the virtual machine to get the Grafana credentials

   vagrant ssh
   cat grafana-creds.yml

5. Visit the Prometheus and Grafana dashboards on the host machine at http://localhost:3000 and http://localhost:9090. Login the Grafana dashboard using the credentials obtained from step 4.

6. Add Prometheus as data source to Grafana using http://prometheus-server-ext.default.svc and import a Kubernetes dashboard to get started e.g. 315, 13332.

To try out Slack notification, create a file slack.yml in the directory ansible/vars/secrets/ before spinning up the virtual machine. In the slack.yml file, provide the slack api url. For example:

---
slack_api_url: <replace with your webhook url>

1. Change directory into the cloned repo

   cd prometheus-grafana-learning

2. Destroy the created virtual machines

   vagrant destroy

(back to top)

If you have a suggestion that would make this better, please fork the repo and create a pull request. Any form of contributions is greatly appreciated!

You can also open an issue with any bugs you found or any suggestions you have. Thank you!

(back to top)

• Setup Prometheus and Grafana monitoring on Kubernetes cluster using Helm
• How Prometheus Monitoring works | Prometheus Architecture explained
• README Template

(back to top)