kmaqsudi/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 originally a fork from Hopsoft (massive love to Hopsoft for setting up the original image) and now we just wrap the official docker image for Graphite. We wrap it and add some configuration to make sitespeed.io metrics to work better.

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

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-aggregation.conf.

The default one looks like this:

retentions = 10m:60d,30m:90d

It will store data for 3 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 Official Graphite Docker container.