Feature/metrics docs

Reopening this PR, against release with addressed comments.
https://github.com/caskdata/cdap/pull/709
this is way too much code just to show how you can use single method. Give me a min to think