pborreli / docker-graphite-statsd

Docker image for Graphite made easy for sitespeed.io

Docker Image for Graphite

Get Graphite running instantly to use with sitespeed.io

This is a fork from Hopsoft Massive love to Hopsoft for setting up the original image.

In this image, Graphite is always setup with Basic Auth (feed your .htpasswd file when starting) and the Graphite data dir is set to /opt/graphite/storage/whisper.

Quick Start

sudo docker run -d \
  --name graphite \
  -p 8080:80 \
  -p 2003:2003 \
  sitespeedio/graphite

This starts a Docker container named: graphite with Basic Auth guest/guest. Please change the login that by feeding your own .htpasswd file when starting the container (more info about how to create your .htpasswd file):

sudo docker run -d \
  --name graphite \
  -p 8080:80 \
  -p 2003:2003 \
  -v /local/path/to/.htpasswd:/etc/nginx/.htpasswd \
  sitespeedio/graphite

And the final config that you should do is map the Graphite data dir outside of your container:

sudo docker run -d \
  --name graphite \
  -p 8080:80 \
  -p 2003:2003 \
  -v /local/path/to/.htpasswd:/etc/nginx/.htpasswd \
  -v /path/to/data/graphite/storage/whisper:/opt/graphite/storage/whisper \
  sitespeedio/graphite

TODO also map log dirs

Data retention

You can change how often data will be stored in the storage-schemas.conf and how metrics will be aggregated over time in storage-aggreagtion.conf.

The default one looks like this:

retentions = 5m:1d,15m:21d,30m:60d

It will store data for 2 months, change that if you need to store data longer. Etsy has good documentation on how to setup your Graphite metrics.

To change it, you can feed the image with a new storage-schemas.conf. The one you want to replace is located
/opt/graphite/conf/storage-schemas.conf

Start your image like this:

sudo docker run -d \
  --name graphite \
  -p 8080:80 \
  -p 2003:2003 \
  -v /local/path/to/.htpasswd:/etc/nginx/.htpasswd \
  -v /path/to/data/graphite/storage/whisper:/opt/graphite/storage/whisper \
  -v /path/to/storage-schemas.conf:/opt/graphite/conf/storage-schemas.conf \
  sitespeedio/graphite

Base Image

Built using Phusion's base image.

• All Graphite related processes are run as daemons & monitored with runit.
• Includes additional services such as logrotate.