doc and monitoring cleanup
feedback from cvan and mstriemer
HOSTNAME is used in a few places, but its different from DOMAIN
Merge pull request #2271 from andymckay/doc-fixin

doc and monitoring cleanup