97 lines
5.8 KiB
Markdown
97 lines
5.8 KiB
Markdown
[](https://travis-ci.org/vegasbrianc/prometheus)
|
|
|
|
# A Prometheus & Grafana docker-compose stack
|
|
|
|
Here's a quick start to stand-up a [Prometheus](http://prometheus.io/) stack containing Prometheus, Grafana and Node scraper to monitor your Docker infrastructure. A big shoutout to [philicious](https://github.com/philicious) for kicking this project off!
|
|
|
|
## Pre-requisites
|
|
Before we get started installing the Prometheus stack. Ensure you install the latest version of docker and [docker-compose](https://docs.docker.com/compose/install/) on your Docker host machine. This has also been tested with Docker for Mac and it works well.
|
|
|
|
## Installation & Configuration
|
|
Clone the project locally to your Docker host.
|
|
|
|
If you would like to change which targets should be monitored or make configuration changes edit the [/prometheus/prometheus.yml](https://github.com/vegasbrianc/prometheus/blob/version-2/prometheus/prometheus.yml) file. The targets section is where you define what should be monitored by Prometheus. The names defined in this file are actually sourced from the service name in the docker-compose file. If you wish to change names of the services you can add the "container_name" parameter in the `docker-compose.yml` file.
|
|
|
|
Once configurations are done let's start it up. From the /prometheus project directory run the following command:
|
|
|
|
$ docker-compose up -d
|
|
|
|
|
|
That's it. docker-compose builds the entire Grafa and Prometheus stack automagically.
|
|
|
|
The Grafana Dashboard is now accessible via: `http://<Host IP Address>:3000` for example http://192.168.10.1:3000
|
|
|
|
username - admin
|
|
password - foobar (Password is stored in the `config.monitoring` env file)
|
|
|
|
## Post Configuration
|
|
Now we need to create the Prometheus Datasource in order to connect Grafana to Prometheus
|
|
* Click the `Grafana` Menu at the top left corner (looks like a fireball)
|
|
* Click `Data Sources`
|
|
* Click the green button `Add Data Source`.
|
|
|
|
<img src="https://github.com/vegasbrianc/prometheus/blob/version-2/images/Add_Data_Source.png" width="400" heighth="400">
|
|
|
|
## Alerting
|
|
Alerting has been added to the stack with Slack integration. 2 Alerts have been added and are managed
|
|
|
|
Alerts - `prometheus/alert.rules`
|
|
Slack configuration - `alertmanager/config.yml`
|
|
|
|
The Slack configuration requires to build a custom integration.
|
|
* Open your slack team in your browser `https://<your-slack-team>.slack.com/apps`
|
|
* Click build in the upper right corner
|
|
* Make a Custom integration
|
|
* Choose Incoming Web Hooks
|
|
* Select which channel
|
|
* Click on Add Incoming WebHooks integration
|
|
* Copy the Webhook URL into the `alertmanager/config.yml` URL section
|
|
* Fill in Slack username and channel
|
|
|
|
View Prometheus alerts `http://<Host IP Address>:9090/alerts`
|
|
View Alert Manager `http://<Host IP Address>:9093`
|
|
|
|
### Test Alerts
|
|
A quick test for your alerts is to stop a service. Stop the node_exporter container and you should notice shortly the alert arrive in Slack. Also check the alerts in both the Alert Manager and Prometheus Alerts just to understand how they flow through the system.
|
|
|
|
High load test alert - `docker run --rm -it busybox sh -c "while true; do :; done"`
|
|
|
|
Let this run for a few minutes and you will notice the load alert appear.
|
|
|
|
## Install Dashboard
|
|
I created a Dashboard template which is available on [Grafana Docker Dashboard](https://grafana.net/dashboards/179). Simply download the dashboard and select from the Grafana menu -> Dashboards -> Import
|
|
|
|
This dashboard is intended to help you get started with monitoring. If you have any changes you would like to see in the Dashboard let me know so I can update Grafana site as well.
|
|
|
|
Here's the Dashboard Template
|
|
|
|
|
|
|
|
Grafana Dashboard - `dashboards/Grana_Dashboad.json`
|
|
Alerting Dashboard - `dashboards/System_Monitoring.json`
|
|
|
|
## Security Considerations
|
|
This project is intended to be a quick-start to get up and running with Docker and Prometheus. Security has not been implemented in this project. It is the users responsability to implement Firewall/IpTables and SSL.
|
|
|
|
Since this is a template to get started Prometheus and Alerting services are exposing their ports to allow for easy troubleshooting and understanding of how the stack works.
|
|
|
|
### Security considerations for production:
|
|
Here are just a couple security considerations for this stack to help you get started.
|
|
* Remove the published ports from Prometheus and Alerting servicesi and only allow Grafana to be accessed
|
|
* Enable SSL for Grafana with a Proxy such as [jwilder/nginx-proxy](https://hub.docker.com/r/jwilder/nginx-proxy/) or [Traefik](https://traefik.io/) with Let's Encrypt
|
|
* Add user authentication via a Reverse Proxy [jwilder/nginx-proxy](https://hub.docker.com/r/jwilder/nginx-proxy/) or [Traefik](https://traefik.io/) for services cAdvisor, Prometheus, & Alerting as they don't support user authenticaiton
|
|
* Terminate all services/containers via HTTPS/SSL/TLS
|
|
|
|
## Troubleshooting
|
|
It appears some people have reported no data appearing in Grafana. If this is happening to you be sure to check the time range being queried within Grafana to ensure it is using Today's date with current time.
|
|
|
|
## Intesting Projects that use this Repo
|
|
Several projects utilize this Prometheus stack. Here's the list of projects:
|
|
|
|
* [Docker Pulls](https://github.com/vegasbrianc/docker-pulls) - Visualize Docker-Hub pull statistics with Prometheus
|
|
* [GitHub Monitoring](https://github.com/vegasbrianc/github-monitoring) - Monitor your GitHub projects with Prometheus
|
|
* [Traefik Reverse Proxy/Load Balancer Monitoring](https://github.com/vegasbrianc/docker-traefik-prometheus) - Monitor the popular Reverse Proxy/Load Balancer Traefik with Prometheus
|
|
|
|
*Have an intersting Project which use this Repo? Submit yours to the list*
|
|
|