Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dokku/docker-grafana-graphite

Docker image with StatsD, Graphite, Grafana 6
https://github.com/dokku/docker-grafana-graphite

docker docker-image dokku grafana graphite paas statsd

Last synced: about 2 months ago
JSON representation

Docker image with StatsD, Graphite, Grafana 6

Awesome Lists containing this project

README

        

# StatsD + Graphite + Grafana 8

[![dokku/docker-grafana-graphite](http://dockeri.co/image/dokku/docker-grafana-graphite)](https://registry.hub.docker.com/u/dokku/docker-grafana-graphite/)

This image contains a sensible default configuration of StatsD, Graphite and Grafana. This image is used as a base for [dokku](https://github.com/progrium/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:

```bash
make up
```

To stop the container

```bash
make down
```

To run container's shell

```bash
make shell
```

To view the container log

```bash
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](https://docs.docker.com/engine/userguide/networking/default_network/binding/) and [Legacy container links](https://docs.docker.com/engine/userguide/networking/default_network/dockerlinks/).

## Building the image yourself

The Dockerfile and supporting configuration files are available in our [Github repository](https://github.com/jlachowski/docker-grafana-graphite).
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](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.