Add docs on new Prometheus support

As part of this, the information on the Diagnostics support has been
moved into the new document so that it is easier to find.