https://github.com/nickstenning/docker-graphite
Graphite + Carbon in a docker image
https://github.com/nickstenning/docker-graphite
Last synced: 12 months ago
JSON representation
Graphite + Carbon in a docker image
- Host: GitHub
- URL: https://github.com/nickstenning/docker-graphite
- Owner: nickstenning
- Created: 2014-05-15T14:51:56.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2018-06-01T18:56:11.000Z (about 8 years ago)
- Last Synced: 2025-04-23T03:46:51.506Z (over 1 year ago)
- Language: Nginx
- Homepage: https://index.docker.io/u/nickstenning/graphite
- Size: 11.7 KB
- Stars: 78
- Watchers: 6
- Forks: 64
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Graphite + Carbon
An all-in-one image running graphite and carbon-cache. **Version**: 0.9.12.
This image contains a sensible default configuration of graphite and
carbon-cache. Starting this container will, by default, bind the the following
host ports:
- `80`: the graphite web interface
- `2003`: the carbon-cache line receiver (the standard graphite protocol)
- `2004`: the carbon-cache pickle receiver
- `7002`: the carbon-cache query port (used by the web interface)
With this image, you can get up and running with graphite by simply running:
docker run -d nickstenning/graphite
If you already have services running on the host on one or more of these ports,
you may wish to allow docker to assign random ports on the host. You can do this
easily by running:
docker run -p 80 -p 2003 -p 2004 -p 7002 -d nickstenning/graphite
You can log into the administrative interface of graphite-web (a Django
application) with the username `admin` and password `admin`. These passwords can
be changed through the web interface.
**N.B.** Please be aware that by default docker will make the exposed ports
accessible from anywhere if the host firewall is unconfigured.
### Data volumes
Graphite data is stored at `/var/lib/graphite/storage/whisper` within the
container. If you wish to store your metrics outside the container (highly
recommended) you can use docker's data volumes feature. For example, to store
graphite's metric database at `/data/graphite` on the host, you could use:
docker run -v /data/graphite:/var/lib/graphite/storage/whisper \
-d nickstenning/graphite
**N.B.** You will need to run the container with suitable permissions to write
to the data volume directory. Carbon and the graphite webapp run as `www-data`
inside the container, but this UID/GID may be mapped inconsistently on the host.
### Technical details
By default, this instance of carbon-cache uses the following retention periods
resulting in whisper files of approximately 2.5MiB.
10s:8d,1m:31d,10m:1y,1h:5y
For more information, see [the
repository](https://github.com/nickstenning/dockerfiles/tree/master/graphite).