add some javadocs for metrics handlers