Metrics should be part of public API, and should be clearly documented similar to HADOOP-5073, so that we can reliably build tools on top of them.
Document the metrics produced by hadoop
Documenting HDFS metrics
Documenting MapReduce metrics
Document time unit to RpcMetrics.java
Document YARN metrics
Document metrics included in MXBean