Imported rubinius/influxdb-grafana to /metrics.

Author: brixen

metrics/Dockerfile

@@ -0,0 +1,46 @@
+
+FROM ubuntu:14.04
+
+# statsd udp data (send rbx data to this port)
+EXPOSE 8125/udp
+# statsd management
+EXPOSE 8126
+# influxdb management UI
+EXPOSE 8083
+# influxdb API
+EXPOSE 8086
+# grafana dashboard UI
+EXPOSE 80
+
+# Install some basic utilities with the OS package manager
+RUN apt-get update -y && apt-get upgrade -y
+RUN apt-get install -y wget curl python-pip supervisor nginx-light npm
+RUN pip install envtpl
+
+# Install statsd and backend and configuration
+RUN npm -g install statsd
+RUN npm -g install statsd-influxdb-backend
+ADD statsd/config.js /statsd/config.js
+# Symbolic link because statsd expects a binary called `node`
+RUN ln -s /usr/bin/nodejs /usr/bin/node
+
+# Install influxdb and setup script
+RUN wget http://s3.amazonaws.com/influxdb/influxdb_latest_amd64.deb
+RUN dpkg -i influxdb_latest_amd64.deb
+ADD influxdb/setup.sh /influxdb/setup.sh
+# Set up influxdb and create the databases
+RUN influxdb/setup.sh
+
+# Install grafana and configuration
+RUN mkdir /src
+RUN wget http://grafanarel.s3.amazonaws.com/grafana-1.9.0.tar.gz -O /src/grafana.tar.gz
+RUN cd /src && tar -xvf grafana.tar.gz && mv grafana-1.9.0 grafana
+ADD grafana/config.js.tpl /src/grafana/config.js.tpl
+ADD grafana/rbx-dash.json /src/grafana/app/dashboards/rbx-dash.json
+ADD grafana/setup.sh /src/grafana/setup.sh
+# Add nginx configuration
+ADD nginx/nginx.conf /etc/nginx/nginx.conf
+
+# Add supervisord configuration and set default command for `docker run`
+ADD supervisord/supervisord.conf /etc/supervisor/conf.d/supervisord.conf
+CMD ["/usr/bin/supervisord", "-c", "/etc/supervisor/conf.d/supervisord.conf"]

metrics/LICENSE

@@ -0,0 +1,56 @@
+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
+```

metrics/README.md

@@ -0,0 +1,68 @@
+
+define(['settings'], function(Settings) {
+  return new Settings({
+      
+      /* Data sources
+      * ========================================================
+      * Datasources are used to fetch metrics, annotations, and serve as dashboard storage
+      *  - You can have multiple of the same type.
+      *  - grafanaDB: true    marks it for use for dashboard storage
+      *  - default: true      marks the datasource as the default metric source (if you have multiple)
+      *  - basic authentication: use url syntax http://username:password@domain:port
+      */
+      
+      // InfluxDB example setup (the InfluxDB databases specified need to exist)
+      datasources: {
+        rbx: {
+          type: 'influxdb',
+          url: "{{ INFLUXDB_SERVER | default("http://localhost:8086") }}/db/rbx",
+          username: 'root',
+          password: 'root',
+        },
+        grafana: {
+          type: 'influxdb',
+          url: "{{ INFLUXDB_SERVER | default("http://localhost:8086") }}/db/grafana",
+          username: 'root',
+          password: 'root',
+          grafanaDB: true
+        },
+      },
+      
+      /* Global configuration options
+      * ========================================================
+      */
+      
+      // specify the limit for dashboard search results
+      search: {
+        max_results: 100
+      },
+      
+      // default home dashboard
+      default_route: '/dashboard/file/rbx-dash.json',
+      
+      // set to false to disable unsaved changes warning
+      unsaved_changes_warning: true,
+      
+      // set the default timespan for the playlist feature
+      // Example: "1m", "1h"
+      playlist_timespan: "1m",
+      
+      // If you want to specify password before saving, please specify it below
+      // The purpose of this password is not security, but to stop some users from accidentally changing dashboards
+      admin: {
+        password: ''
+      },
+      
+      // Change window title prefix from 'Grafana - <dashboard title>'
+      window_title_prefix: 'RBX Dashboard - ',
+      
+      // Add your own custom panels
+      plugins: {
+        // list of plugin panels
+        panels: [],
+        // requirejs modules in plugins folder that should be loaded
+        // for example custom datasources
+        dependencies: [],
+      }
+    });
+});