statsd docs (Issue google#2002) (google#2005)

* statsd documentation

Author: Xander Grzywinski

docs/storage/README.md

@@ -10,5 +10,5 @@ cAdvisor supports exporting stats to various storage driver plugins. To enable a
 - [Kafka](http://kafka.apache.org/). See the [documentation](kafka.md) for usage.
 - [Prometheus](https://prometheus.io). See the [documentation](prometheus.md) for usage and examples.
 - [Redis](http://redis.io/)
-- [StatsD](https://github.com/etsy/statsd)
+- [StatsD](https://github.com/etsy/statsd). See the [documentation](statsd.md) for usage and examples.
 - `stdout` - write stats to standard output.

docs/storage/statsd.md

@@ -0,0 +1,26 @@
+# Exporting cAdvisor Stats to statsd
+
+cAdvisor supports exporting stats to [statsd](https://github.com/etsy/statsd). To use statsd, you need to pass some additional flags to cAdvisor telling it where to find statsd:
+
+Set the storage driver as statsd.
+
+```
+ -storage_driver=statsd
+```
+
+Specify what statsd instance to push data to:
+
+```
+ # The *ip:port* of the instance. Default is 'localhost:8086'
+ -storage_driver_host=ip:port
+```
+
+# Examples
+
+The easiest way to get up an running is to start the cadvisor binary with the `--storage_driver` and `--storage_driver_host` flags.
+
+```
+cadvisor --storage_driver="statsd" --storage_driver_host="localhost:8125"
+```
+
+The default port for statsd is 8125, so this wil start pumping metrics directly to it.