Feature/metrics docs

Reopening this PR, against release with addressed comments.
https://github.com/caskdata/cdap/pull/709
- **gauge:** Sets the metric named ``metricName`` to a specific value::

  gauge(metricName, value)