doc and monitoring cleanup

I wonder if we can streamline this troubleshooting. it's kind of a PITA.