Feature/metrics docs

Reopening this PR, against release with addressed comments.
https://github.com/caskdata/cdap/pull/709
Maybe add before "Examples":
"If \`\`runs/\<run-id>/\`\`is omitted, the metric will be aggregated across all runs of the element."
Sasha, is this accurate?