StatsD + Graphite + Grafana 8

This image contains a sensible default configuration of StatsD, Graphite and Grafana. This image is used as a base for dokku graphite-statsd plugin.

There are two ways for using this image:

Using the Docker Index

All you need as a prerequisite is having docker, docker-compose, and make installed on your machine. The container exposes the following ports:

• 80: the Grafana web interface.
• 81: the Graphite web port
• 2003: the Carbon port.
• 8125: the StatsD port.
• 8126: the StatsD administrative port.

To start a container with this image you just need to run the following command:

make up

To stop the container

make down

To run container's shell

make shell

To view the container log

make tail

If you already have services running on your host that are using any of these ports, you may wish to map the container ports to whatever you want by changing left side number in the --publish parameters. You can omit ports you do not plan to use. Find more details about mapping ports in the Docker documentation on Binding container ports to the host and Legacy container links.

Building the image yourself

The Dockerfile and supporting configuration files are available in our Github repository. This comes specially handy if you want to change any of the StatsD, Graphite or Grafana settings, or simply if you want to know how tha image was built. The repo also has build and start scripts to make your workflow more pleasant.

Using the Dashboards

Once your container is running all you need to do is:

• open your browser pointing to http://localhost:80 (or another port if you changed it)
  • Docker with VirtualBox on macOS: use docker-machine ip instead of localhost
• login with the default username (admin) and password (admin)
• open existing dashboard (or create a new one) and select 'Local Graphite' datasource
• play with the dashboard at your wish...

Persisted Data

When running make up, directories are created on your host and mounted into the Docker container, allowing graphite and grafana to persist data and settings between runs of the container.

Now go explore

We hope that you have a lot of fun with this image and that it serves it's purpose of making your life easier.