From c1dfdcbb2792304d18ad012ad2edf69388e106ff Mon Sep 17 00:00:00 2001 From: Ivan Topolnjak Date: Sun, 27 Apr 2014 22:36:02 -0300 Subject: + site: announce the Kamon/StatsD/Graphite/Grafana Docker image --- site/src/main/jekyll/_layouts/post.html | 6 ++- ...27-get-started-quicker-with-our-docker-image.md | 56 +++++++++++++++++++++ .../jekyll/assets/img/kamon-statsd-grafana.png | Bin 315858 -> 335283 bytes site/src/main/jekyll/statsd/index.md | 4 +- 4 files changed, 64 insertions(+), 2 deletions(-) create mode 100644 site/src/main/jekyll/_posts/2014-04-27-get-started-quicker-with-our-docker-image.md diff --git a/site/src/main/jekyll/_layouts/post.html b/site/src/main/jekyll/_layouts/post.html index c00467d4..db386670 100644 --- a/site/src/main/jekyll/_layouts/post.html +++ b/site/src/main/jekyll/_layouts/post.html @@ -8,4 +8,8 @@ layout: default
{{ content }} -{% include disqus.html %} +
+
+ {% include disqus.html %} +
+ 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: + + diff --git a/site/src/main/jekyll/assets/img/kamon-statsd-grafana.png b/site/src/main/jekyll/assets/img/kamon-statsd-grafana.png index 606ff7e6..da031b16 100644 Binary files a/site/src/main/jekyll/assets/img/kamon-statsd-grafana.png and b/site/src/main/jekyll/assets/img/kamon-statsd-grafana.png differ diff --git a/site/src/main/jekyll/statsd/index.md b/site/src/main/jekyll/statsd/index.md index 8128626b..ec818521 100644 --- a/site/src/main/jekyll/statsd/index.md +++ b/site/src/main/jekyll/statsd/index.md @@ -87,6 +87,8 @@ Visualization and Fun StatsD is widely used and there are many integrations available, even alternative implementations that can receive UDP messages with the StatsD protocol, you just have to pick the option that best suits you. For our internal testing we choose to use [Graphite](http://graphite.wikidot.com/) as the StatsD backend and [Grafana](http://grafana.org) to create -beautiful dashboards with very useful metrics. Have an idea of how your metrics data might look like in Grafana: +beautiful dashboards with very useful metrics. Have an idea of how your metrics data might look like in Grafana with the +screenshot bellow or use our [docker image](https://github.com/kamon-io/docker-grafana-graphite) to get up and running +in a few minutes and see it with your own metrics! ![statsD](/assets/img/kamon-statsd-grafana.png "Grafana Screenshot") -- cgit v1.2.3