prometheus/README.md

45 lines
2.5 KiB
Markdown
Raw Normal View History

2015-08-18 13:37:24 +02:00
## A Prometheus docker-compose stack
2015-08-19 12:22:46 +02:00
Here's a quick start to stand-up a [Prometheus](http://prometheus.io/) stack containing Prometheus server, container-exporter, and the Prometheus Dashboard to monitor your Docker infrastructure.
2015-08-18 23:36:06 +02:00
##Pre-requisites
Before we get started installing the Prometheus stack. Ensure you install [docker-compose](https://docs.docker.com/compose/install/) on your Docker host machine.
2015-08-18 23:36:06 +02:00
##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 [/prom/prometheus.yml](https://github.com/vegasbrianc/prometheus/blob/master/prom/prometheus.yml#L30) file. The targets section. The targets section is where you define which componets(data exporters) 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 change 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 commands:
$ docker-compose up
$ docker-compose start
The Prometheus stack should now be running. To access the different components:
2015-08-19 11:02:44 +02:00
Prometheus: `http://<Host IP Address>:9090>` for example http://192.168.10.1:9090
2015-08-19 11:02:25 +02:00
Prometheus Dashboard: `http://<Host IP Address>:3000` for example http://192.168.10.1:3000
## Post Configuration
Now we need to connect the Prometheus Dashboard to the Prometheus installation. Access the Prom Dash as mentioned above.
2015-08-19 11:11:32 +02:00
* Click the "Server" Menu at the top
* Click "New Server"
* Input desired name, Prometheus server IP and port (`http://<Host IP Address>:9090>` ) and select Prometheus for server type.
2015-08-19 11:11:32 +02:00
![PromDash New Server](https://github.com/vegasbrianc/prometheus/blob/master/New_server.png)
## Configure Dashboards
Let's create our first Dashboard. Head over up to the Dashboard menu. First, create a new directory. Next, create a new Dashboard.
Here's a quick Dashboard I put together as an example.
## Sample Dashboard Queries
The queries used in the example dashboard are located here - [Dashboard Queries](https://github.com/vegasbrianc/prometheus/blob/master/dashboard_queries.txt)
![PromDash Screenshot](https://github.com/vegasbrianc/prometheus/blob/master/Dashboard_example.png)
## ToDo
* Integrate and configure Alerting.
2015-08-19 13:31:31 +02:00
* Make a separate stack with just cAdvisor as the metric collection
2015-08-18 23:36:06 +02:00