Grafana + Graphite + statsd + docker getting started

grafana.md

This provides a minimal setup for running grafana, graphite and statsd in docker containers for experimenting. Not suitable for production environment as additional security configuration is required.

Assuming you have docker installed and ready for use:

1. Run official grafana image:

docker run -d -p 3000:3000 grafana/grafana

2. Run hopsoft/docker-graphite-statsd image:

docker run -d\
 --name graphite\
 --restart=always\
 -p 80:80\
 -p 2003-2004:2003-2004\
 -p 2023-2024:2023-2024\
 -p 8125:8125/udp\
 -p 8126:8126\
 hopsoft/graphite-statsd

3. Enter grafana admin console at localhost:3000. Default user/pass is admin@localhost/admin

4. Click "Create your first data source". Give it a name such as "GraphiteDS" and under HTTP Settings set the URL to "http://localhost:80" and Access to "direct". Click Add, then you should see the message "Data source is working".

Optional steps

5. To generate some random stats, open a separate terminal and run

while true; do echo -n "example:$((RANDOM % 100))|c" | nc -w 1 -u 127.0.0.1 8125; done

5. Go back to Grafana Home Dashboard (localhost:3000) and click "Create your first dashboard";

6. Add a new Graph panel and edit it. Under the Metrics tab, set the data source to GraphiteDS (or the name you chose);

7. in the "A" row, click "select metrics" then "stats". Now click "select metrics" to the right then click "example" (this name comes from step 5);

8. Done! If you followed the steps correctly you should see some sample data in the panel.