Skip to content


Switch branches/tags

The Prometheus Playground

This repo houses a variety of Docker-Compose-based "sandbox" projects showcasing the Prometheus monitoring system. All projects are "turnkey" and require just a single docker-compose up command to run.

Each sandbox project has a README with an explanation of the project, a docker-compose.yml configuration file for Docker Compose, and other necessary resources (config files, Dockerfiles, etc.). To run a project, navigate to the appropriate directory and run make run (which is just an alias for docker-compose up --build). This will run the project in the foreground. To run the project in detached mode, use make run-detached.


In order to run the sandbox projects you'll need to install Docker and Docker Compose and have a Docker daemon running locally.


Directory Scenario
alertmanager Prometheus monitors a basic web service and notifies Alertmanager if the service is down; Alertmanager, in turns, notifies a web service via webhook
blackbox-exporter A BlackBox prober exporter probes a simple web service and provides probe-based metrics to Prometheus
cadvisor Prometheus scrapes cAdvisor-gathered metrics for several containers
federation Three Prometheus instances run together as a single federation
file-sd A Prometheus instance discovers a simple instrumented web service via file-based service discovery
go-app An instrumented Go application using the Prometheus Go client
haproxy Prometheus runs behind HAProxy, which acts as a reverse proxy and provides basic auth and TLS encryption
nginx Prometheus runs behind nginx, which acts as a reverse proxy and provides basic auth and TLS encryption
node-exporter Prometheus scrapes Linux host metrics from a Node Exporter
python-flask-app An instrumented Flask application demonstrating the Prometheus Python client


Turnkey sandbox projects demonstrating a wide variety of Prometheus use cases




Code of conduct





No releases published


No packages published