Skip to content

πŸ“ˆ A simple, single-node, Docker-based Prometheus monitoring stack

Notifications You must be signed in to change notification settings

danguita/prometheus-monitoring-stack

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

10 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Prometheus monitoring stack

πŸ“ˆ A simple, single-node, Docker-based Prometheus monitoring stack

Stack overview

Features

  • Well known monitoring stack.
  • Almost no configuration.
  • Minimal requirements.
  • High portability.

Requisites

Only Docker and Docker compose are required to build the entire stack. Check out the installation instructions.

Configuration

After cloning the repo on your Docker host, copy the example environment file to set your own values:

$ cp .env.example .env

Here are the environment variables and a short description for each:

GF_SECURITY_ADMIN_PASSWORD=secret                                 # Password for the "admin" user in Grafana
EMAIL=mark@facebook.com                                           # Email address to register with `letsencrypt`
DOMAIN=my-little-monitor.facebook.com                             # Domain name to be used by the Nginx proxy
ALERT_SLACK_USERNAME=Prometheus                                   # Slack username in Prometheus server alerts
ALERT_SLACK_CHANNEL="#notifications"                              # Slack channel for Prometheus server alerts
ALERT_SLACK_INCOMING_WEBHOOK_URL=https://hooks.slack.com/whatever # Slack's incoming webhook URL to deliver Prometheus server alerts

Add your own checks (optional)

All rules defined in config/alert.rules will be loaded by Alertmanager. A couple of pretty basic alerts are provided as part of the stack, but feel free to add yours. Check out the alerting rules docs.

Installation and usage

From the root directory of this repo, run the command below:

$ docker-compose up -d

If everything goes well, the Grafana UI should be avilable at the https:// DOMAIN you specified:

e.g. https://my-little-monitor.facebook.com

Grafana Data Source set up

In order to reach the Prometheus container, it is needed to create a Prometheus Data Source with the proper URL in Grafana:

  • URL: http://prometheus:9090
  • Access: proxy

screen shot 2017-02-14 at 12 15 49 pm

After doing so, you are ready to start querying data.

This is how the Grafana UI with a custom dashboard looks like:

screen shot 2017-02-14 at 12 14 35 pm

Disclaimer and final words

This is just a bunch of scripts and stuff that I use to get some visibility on single-node server configurations, so please take them as a starting point. For complex architectures and custom instrumentation, extra configuration might be needed.

Also, please note that the node_exporter is being deployed as a Docker container, so it might not be exposing metrics from the actual host system.

Having said that, any feedback is very welcomed πŸ’ͺ

About

πŸ“ˆ A simple, single-node, Docker-based Prometheus monitoring stack

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published