Public | Automated Build

Last pushed: 19 days ago
Short Description
Install full graphite Stack to use with grafana
Full Description

docker-graphite

A Docker container for an complete graphite Stack. Usable in combination with Grafana.

Status



Build

Your can use the included Makefile.

To build the Container: make build

To remove the builded Docker Image: make clean

Starts the Container: make run

Starts the Container with Login Shell: make shell

Entering the Container: make exec

Stop (but not kill): make stop

History make history

Docker Hub

You can find the Container also at DockerHub

get

docker pull bodsch/docker-graphite

run

docker run \
  --rm \
  --interactive \
  --tty \
  --publish=2003:2003 \
  --publish=7002:7002 \
  --publish=8088:8080 \
  --volume=/data/docker/graphite:/srv \
  --hostname=graphite \
  --name=graphite \
  bodsch/docker-graphite

Notes:

  • Please make sure to specify a hostname, so that internal metrics of carbon are not saved with a temporary hostname

supported Environment Vars

  • DATABASE_TYPE (default: sqlite)
  • MYSQL_HOST
  • MYSQL_PORT
  • MYSQL_ROOT_USER (default: root)
  • MYSQL_ROOT_PASS
  • MEMCACHE_HOST
  • MEMCACHE_PORT (default: 11211)
  • DATABASE_GRAPHITE_PASS (default: graphite)
  • USE_EXTERNAL_CARBON (default: false)

Limitations

The Database store only Dashboard and i think, grafana are the better Tools for this part.

Conclusion, I do not use the database feature of graphite (sorry, guys).
The sqlite database will only created in the /tmp directory and not used.

When your using a external carbon-writer (like go-carbon) you do not need the internal carbon.
You can disable this part with USE_EXTERNAL_CARBON.

includes

  • graphite-web
  • whisper
  • carbon-cache
  • nginx

Ports

  • 2003: the Carbon line receiver port (tcp and udp)
  • 7002: the Carbon cache query port
  • 8080: the Graphite-Web port

Storage Schemas and Retention Period

The configuration is located at /opt/graphite/conf/storage-schemas.conf and has this default entries:

[carbon]
pattern = ^carbon\.
retentions = 60:90d

[default_1min_for_1day]
pattern = .*
retentions = 60s:1d

Each section has:

  • a name, specified inside square brackets
  • a regular expression, specified after pattern=
  • a retention rate line, specified after retentions=

As example for retention we use the following

pattern = ^telegraf\.
retentions = 30s:7d,5m:30d,10m:1y

The regular expression pattern will match any metric that starts with telegraf.

Additionally, this example uses multiple retentions:

  • each data point represents 30 seconds and we want to keep up to 7 days of data with such frequency
  • all historical data for the last 30 days is stored in 5 minute intervals
  • all historical data for the last year is stored in 10 minute intervals

To calculate the whisper file size, I can recommend this tool: whisper-calculator
(gist)

Docker Pull Command
Owner
bodsch
Source Repository