Added nimbus tutorial

Author: Tom Clark

index.md

@@ -15,6 +15,12 @@ In the future, I'll add cookies so the site will apply filters for you and a cen
 
 This project originated as a full-blown rails app backed by a database, and I reached a point where I needed user accounts and git repos.  Dreading that, I threw it all away for a simpler, git-based workflow to upload data.  I sincerely hope you enjoy it and find it useful.
 
+Newest Tutorials
+----------------
+
+ * [Retrieving Storm Cluster Statistics from Nimbus](/pages/retrieving-storm-data-from-nimbus.html)
+ * [Installing MySQL](/pages/installing-mysql.html)
+ * [Hello, World!](/pages/hello-world.html)
 
 Examples
 --------

pages/retrieving-storm-data-from-nimbus.md

@@ -0,0 +1,99 @@
+---
+layout: default
+title: Retrieving Storm Cluster Statistics from Nimbus
+---
+
+# Retrieving Storm Cluster Statistics from Nimbus
+
+This tutorial will show how to obtain basic storm topology statistics from nimbus (similar to the information show in the storm ui dashboard) so you can store that data in a separate ___location -- such as graphite -- for monitoring.  Since storm topologies are thrift-based, you can use almost any language to connect to nimbus to download your data.
+
+<div
+  markdown="1"
+  class="tutorial"
+  data-github-author="Whitespace"
+  data-license="http://creativecommons.org/licenses/by/3.0/"
+  data-facets='{"Operating System": "OS X 10.7", "Language": "Ruby", "Storm Version": "0.7.0", "Thrift Version": "0.7.0", "Package Management": "Homebrew"}'>
+
+## Assumptions
+
+We assume you'll store your data in `~/code`.  We also assume that your homebrew is newer enough that the `/usr/local` directory is homebrew's git repo.
+
+## Setup
+
+Let's make a ___location to store our project:
+
+{% highlight sh %}
+mkdir -p ~/code/nimbus-thrift-demo
+{% endhighlight %}
+
+## Download the Storm Source Code
+
+In order to connect to nimbus, we need to get the `storm.thrift` file from the storm source, and use that to generate the thrift bindings in ruby:
+
+{% highlight sh %}
+cd ~/code
+wget https://github.com/downloads/nathanmarz/storm/storm-0.7.0.zip
+unzip storm-0.7.0.zip
+{% endhighlight %}
+
+## Install Thrift 0.7.0 and the Thrift Gem
+
+Now let's install the same version of thrift that storm 0.7.0 uses:
+
+{% highlight sh %}
+cd /usr/local
+brew update
+brew versions thrift
+git checkout 141ddb6 /usr/local/Library/Formula/thrift.rb
+brew install thrift
+{% endhighlight %}
+
+And the thrift gem:
+
+{% highlight sh %}
+gem install thrift
+{% endhighlight %}
+
+## Generate the Ruby Bindings
+
+{% highlight sh %}
+cd ~/code/nimbus-thrift-demo
+cp ~/code/storm-0.7.0/src/storm.thrift .
+thrift --gen rb storm.thrift
+{% endhighlight %}
+
+## Connect to Nimbus
+
+Now that we have the ruby bindings in place, we can create a sample app to connect to our nimbus cluster.  Copy the following to `test.rb`, replacing `localhost` with the hostname of your nimbus instance:
+
+{% highlight ruby %}
+$:.push('gen-rb')
+
+require 'rubygems'
+require 'thrift'
+require 'nimbus'
+
+begin
+  transport = Thrift::FramedTransport.new(Thrift::Socket.new('localhost', 6627))
+  protocol = Thrift::BinaryProtocol.new(transport)
+  client = Nimbus::Client.new(protocol)
+
+  transport.open
+  summary = client.getClusterInfo
+  puts summary.inspect
+  transport.close
+
+rescue Thrift::Exception => tx
+  print 'Thrift::Exception: ', tx.message, "\n"
+end
+{% endhighlight %}
+
+Now we can run our test app:
+
+{% highlight sh %}
+ruby test.rb
+{% endhighlight %}
+
+Now you can take that data and write it to where you'd like.  Enjoy!
+
+</div>

pages/table_of_contents.md

@@ -7,6 +7,7 @@ ignore: true
 This is the TOC.  It should not be edited
 
 <!--- BEGIN TOC -->
+ * [Retrieving Storm Cluster Statistics from Nimbus](/pages/retrieving-storm-data-from-nimbus.html)
  * [Installing MySQL](/pages/installing-mysql.html)
  * [Hello, World!](/pages/hello-world.html)
 <!--- END TOC -->