Feature/metrics docs

Reopening this PR, against release with addressed comments.
https://github.com/caskdata/cdap/pull/709
since that is out of the scope of this PR, and needs a bigger change. we can decide and make the change later.