+ site: announce the Kamon/StatsD/Graphite/Grafana Docker image

1 files changed, 56 insertions, 0 deletions

diff --git a/site/src/main/jekyll/_posts/2014-04-27-get-started-quicker-with-our-docker-image.md b/site/src/main/jekyll/_posts/2014-04-27-get-started-quicker-with-our-docker-image.md
new file mode 100644
index 00000000..f75628c6
--- /dev/null
+++ b/site/src/main/jekyll/_posts/2014-04-27-get-started-quicker-with-our-docker-image.md
@@ -0,0 +1,56 @@
+---
+layout: post
+title: Get started quicker with our docker image
+date: 2014-04-27
+categories: teamblog
+tags: announcement
+---
+
+We are very excited to see people adopting Kamon as their monitoring tool for reactive applications and, of course, we
+want to keep growing both in users base and features. According to our site metrics, the most visited section is the one
+describing our [StatsD module](/statsd/), that made us think, what can we do to make it easier for people to get started
+with Kamon and StatsD?, well, that's an easy question to answer: build a package containing all the required
+infrastructure and plumping, and let the users just focus on what cares to them, their apps and their metrics. That's
+why today we are publishing a Docker image with all that you need to get started in a few minutes!
+
+
+The image contains a sensible default configuration of StatsD, Graphite and Grafana, and comes bundled with a example
+dashboard that gives you the basic metrics currently collected by Kamon for both Actors and Traces. There are two ways
+for using this image:
+
+
+### Using the Docker Index ###
+
+This image is published under [Kamon's repository on the Docker Index](https://index.docker.io/u/kamon/) and all you
+need as a prerequisite is having Docker installed on your machine. The container exposes the following ports:
+
+- `80`: the Grafana web interface.
+- `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
+docker run -d -v /etc/localtime:/etc/localtime:ro -p 80:80 -p 8125:8125/udp -p 8126:8126 --name kamon-grafana-dashboard kamon/grafana_graphite
+```
+
+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 `-p` parameters. Find more details about mapping ports
+in the [Docker documentation](http://docs.docker.io/use/port_redirection/#port-redirection).
+
+
+### Building the image yourself ###
+
+The Dockerfile and supporting configuration files are available in our [Github repository](https://github.com/kamon-io/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 Dashboard ###
+
+Once your container is running all you need to do is open your browser pointing to the host/port you just published and
+play with the dashboard at your wish. We hope that you have a lot of fun with this image and that it serves it's
+purpose of making your life easier. This should give you an idea of how the dashboard looks like when receiving data
+from one of our toy applications:
+
+<img class="img-responsive" src="/assets/img/kamon-statsd-grafana.png">