influxdb-grafana

Docker container for using InfluxDB + Grafana to consume Rubinius Metrics StatsD output.

Usage

1. Install docker.

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. 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.

   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.

   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:

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:

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