updated logging and troubleshooting notes