https://github.com/rubinius/influxdb-grafana
Docker container for using InfluxDB + Grafana to consume Rubinius Metrics StatsD output
https://github.com/rubinius/influxdb-grafana
Last synced: about 2 months ago
JSON representation
Docker container for using InfluxDB + Grafana to consume Rubinius Metrics StatsD output
- Host: GitHub
- URL: https://github.com/rubinius/influxdb-grafana
- Owner: rubinius
- License: mpl-2.0
- Created: 2014-12-13T00:44:16.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2015-01-14T01:26:00.000Z (over 10 years ago)
- Last Synced: 2025-03-26T07:36:26.574Z (2 months ago)
- Language: JavaScript
- Size: 188 KB
- Stars: 11
- Watchers: 54
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
influxdb-grafana
================
Docker container for using InfluxDB + Grafana to consume Rubinius Metrics StatsD output.
## Usage
1. **[Install docker](https://docs.docker.com/installation/)**.
2. **Run an instance of the container**. If this is the first time you're running it, docker will automatically download the stack of images that make up the container from [the automated build of this repository](https://registry.hub.docker.com/u/rubinius/influxdb-grafana/). The following command will run the container as a daemon (`-d`), mapping port `8125` of `localhost` to the container's `8125` statsd port, port `8086` of `localhost` to the container's `8086` influxdb query port, and port `80` of `localhost` to the container's `80` port serving the grafana interface. Depending on how docker is installed, you may need to run this command with `sudo`.
```shell
docker run -d \
-p 8125:8125/udp \
-p 8086:8086 \
-p 80:80 \
rubinius/influxdb-grafana
```
3. **Run your application** with Rubinius configured to output metrics to statsd at `localhost:8125`.
```shell
RBXOPT="-Xsystem.metrics.target=statsd \
-Xsystem.metrics.statsd.server=localhost:8125" \
rbx # (your app here)
```
4. **Open the dashboard** in your browser at `http://localhost:80`. The grafana dashboard will run in your browser, sending queries for data to influxdb at `http://localhost:8086`.
### Usage on Remote Hosts
The usage instructions above assume that the docker container is being run and exposing its ports on the same host as the browser. This is not likely to be true if you are running the container as a service to be connected to from other machines. In that case, you must be sure to replace `localhost` in the steps above with the host name or IP address running the container with the correct exposed or forwarded port.
As mentioned in step 4 above, grafana runs in your browser, sending queries for data to influxdb at `http://localhost:8086`. This also needs to be replaced with the correct remotely accessible address by passing an environment variable into the docker container. For example, if the remote address in your setup is is `rbx.myhost.com`, the docker container should be run on that host with the command:
```shell
docker run -d \
-p 8125:8125/udp \
-p 8086:8086 \
-p 80:80 \
-e INFLUXDB_SERVER=http://rbx.myhost.com:8086 \
rubinius/influxdb-grafana
```
### Usage on Mac OS X
Because docker relies on features of the Linux kernel, it does not run containers natively in Mac OS X - it hosts containers inside of a Linux VM called `boot2docker`. One consequence of this is that the ports mapped to the docker host from containers are not mapped to `localhost` of OS X, but to the `boot2docker` host. Therefore, it must be treated like a 'remote host' using the steps outlined above, substituting `localhost` with the IP address given the command `boot2docker ip`. For example, if the `boot2docker ip` address in your setup is is `192.168.59.103`, the docker container could be run with the command:
```shell
docker run -d \
-p 8125:8125/udp \
-p 8086:8086 \
-p 80:80 \
-e INFLUXDB_SERVER=http://192.168.59.103:8086 \
rubinius/influxdb-grafana
```