How to enable Change Auditor Coordinator, Agent, and Plug-in debug logging (4351087)

This article outlines how to enable Debug logging for Change Auditor Coordinator, Agent, and Plug-ins. This should only be enabled for troubleshooting purposes and when advised to do so by a Support Engineer. Debugging should be turned off immediately after the requested testing, as to not create very large log files from normal process use.

Instructions for Turning on Debug Logging for Change Auditor Coordinators
================================================================================
If non-default installation location of the Coordinator, please modify the paths accordingly.

1) On the Coordinator server, go to C:\Program Files\Quest\ChangeAuditor\Service
2) Open the ChangeAuditor.Service.exe.config in Notepad. (You may need to open Notepad as an Administrator and navigate to this file if you are not able to save the file at the end of these steps.
3) Change the line that says 'level value="INFO"'  to 'level value="DEBUG"'

NOTE: Change the value in the root xml node. The first entry you would find from the top of the config file is only a comment in XML.

4) Restart the Coordinator
5) Following reproduction of the issue collect the log files (*.nptlog – “Trace Log Document” type files) from the following folder: C:\Program Files\Quest\ChangeAuditor\Service\Logs
6) Return the values to the above defaults.

Instructions for Turning on Debug Logging for Change Auditor Agents
================================================================================
If non-default installation location of the Agents, please modify the paths accordingly.

1) On the Agent Server, go to C:\Program Files\Quest\ChangeAuditor\Agent\
2) Edit the file ChangeAuditor.dll.TraceLogConfig.xml
3) Change the line that says 'priority value="INFO"' to 'priority value="DEBUG"'
4) Optionally, control the number of trace files retained and the size of each trace file. Trace files are 10MB max size by default.
5) Allow 30 seconds for the changes to take effect.
6) Following reproduction of the issue collect the log files (*.nptlog – “Trace Log Document” type files) from the following folder: C:\Program Files\Quest\ChangeAuditor\Agent\Logs
7) Return the values above to defaults.

Instructions for Turning on Debug Logging for Change Auditor Client
================================================================================
If non-default installation location of the client, please modify the paths accordingly.

1) On the client machine, go to C:\Program Files\Quest\ChangeAuditor\Client, and open ChangeAuditor.exe.config with Notepad.
2) Search for 'level value="INFO"' and change it to 'level value="DEBUG"'
3) Save the file.
4) Restart the client (make sure to open it as Administrator by right-clicking the icon > Run As... > Run as Administrator).
5) Once the tests are complete, be sure to switch it back by returning the value to defaults and then restart the client.

 

Instructions for Turning on Debug Logging for Change Auditor Web Client
================================================================================
If non-default installation location of the client, please modify the paths accordingly.

1) On the client machine, go to C:\Program Files\Quest\ChangeAuditor\WebClient, and open web.config with Notepad.
2) Search for 'level value="INFO"' and change it to 'level value="DEBUG"'
3) Save the file.
4) Once the tests are complete, be sure to switch it back by returning the value to defaults.

Instructions for Turning on Debug Logging for Change Auditor for Active Directory Plug-in
=====================================================================================
To turn ON extended Plug-in for AD logging:

1. Open the registry editor, by selecting Start | Run | type regedit.
2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Quest\ChangeAuditor for Active Directory.
3. Modify the "LoggingLevel" value to "5". Typically this is enough though level "7" is verbose mode and may be required under some conditions.
4. Modify the "LoggingMaxFiles" to higher value if needed.
5. Allow 30 seconds for the changes to take effect.
6. Following reproduction of the issue collect logs (*.nptlog – “Trace Log Document” type files) from the following folder: C:\Program Files\Quest\ChangeAuditor\Agent\Plug-in for Active Directory\

To turn OFF extended Plug-in for AD logging:
1. Open the registry editor, by selecting Start | Run | type regedit.
2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Quest\ChangeAuditor for Active Directory.
3. Modify the "LoggingLevel" value to "3".

Instructions for Turning on Debug Logging for Change Auditor for Windows File Servers Plug-in
=====================================================================================
To turn ON extended Plug-in for Windows File Servers logging:

1. Open the registry editor, by selecting Start | Run | type regedit.
2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Quest\ChangeAuditor for Windows File Servers.
3. Modify the "LoggingLevel" value to "5".
4. Modify the "LoggingMaxFiles" to higher value if needed.
5. Allow 30 seconds for the changes to take effect.
6. Following reproduction of the issue collect logs (*.nptlog – “Trace Log Document” type files) from the following folder: C:\Program Files\Quest\ChangeAuditor\Agent\Plug-in for Windows File Servers\Logs\.

To turn OFF extended Plug-in for Windows File Servers logging:
1. Open the registry editor, by selecting Start | Run | type regedit.
2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Quest\ChangeAuditor for Windows File Servers
3. Modify the "DumpToLog value to "3".

Instructions for Turning on Debug Logging for Change Auditor for Exchange Plug-in
=====================================================================================
To turn ON extended Plug-in for Exchange logging:

1. Open the registry editor, by selecting Start | Run | type regedit.
2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Quest\ChangeAuditor for Exchange\Logging\.
3. Modify the "LoggingLevel" value to "3".
4. Modify the "LoggingMaxFiles" to higher value if needed.
5. Allow 30 seconds for the changes to take effect.
6. Following reproduction of the issue collect logs (*.nptlog – “Trace Log Document” type files) from the following folder: C:\Program Files\Quest\ChangeAuditor\Agent\Plug-in for Exchange\CAEXLOGS\.

To turn OFF extended Plug-in for Exchange logging:
1. Open the registry editor, by selecting Start | Run | type regedit.
2. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Quest\ChangeAuditor for Exchange\Logging\.
3. Modify the "LoggingLevel" value to "1".