Adding extended logging to Datto RMM
To enable extended logging, perform the following steps. Remember to remove the extended logging from the devices after gathering the trace logs.
IMPORTANT When extended logging is activated for log components, masked variables will be visible in clear text in the log file.
Windows
- On your device, navigate to the nlog.config file:
- Make a copy of the nlog.config file before making any changes to it.
- Right-click on nlog.config and edit the file:
- Save and close the file.
- Restart the Datto RMM Agent. Refer to Restarting the Datto RMM Agent.
Operating System | Path |
---|---|
Windows 32-bit | %ProgramFiles% > CentraStage > nlog.config |
Windows 64-bit | %ProgramFiles(x86)% > CentraStage > nlog.config |
NOTE You may need to change the write permissions for the nlog.config file to allow you to edit the file and save the changes.
FROM:
logger name="*" minlevel="Info" writeTo="file" />
TO:
logger name="*" minlevel="Trace" writeTo="file" />
Now, when you view the Log.txt file, the extra lines containing DEBUG information will appear.
- Navigate to %ProgramData% > CentraStage > AEMAgent > nlog.config.
- Make a copy of the nlog.config file before making any changes to it.
- Right-click on nlog.config and edit the file:
- Save and close the file.
- Restart the Datto RMM Agent. Refer to Restarting the Datto RMM Agent.
NOTE You may need to change the write permissions for the nlog.config file to allow you to edit the file and save the changes.
FROM:
<rules>
<logger name="log" minlevel="info" writeTo="log,console"></logger>
<logger name="alert" minlevel="info" writeTo="alert"></logger>
<logger name="error" minlevel="info" writeTo="error"></logger>
<logger name="poll" minlevel="info" writeTo="poll"></logger>
</rules>
TO:
<rules>
<logger name="log" minlevel="trace" writeTo="log,console"></logger>
<logger name="alert" minlevel="trace" writeTo="alert"></logger>
<logger name="error" minlevel="trace" writeTo="error"></logger>
<logger name="poll" minlevel="trace" writeTo="poll"></logger>
</rules>
macOS
- Navigate to Applications > AEM Agent.app > Contents > Resources > nlog.config.
- Make a copy of the nlog.config file before making any changes to it.
- Right-click on nlog.config and edit the file:
- Save and close the file.
- Restart the Datto RMM Agent. Refer to Restarting the Datto RMM Agent.
NOTE You may need to change the write permissions for the nlog.config file to allow you to edit the file and save the changes.
FROM:
<rules>
<logger name="Tray_Mac.*" minlevel="Info" writeTo="TrayFile" />
<logger name="*" minlevel="info" writeTo="file" />
<logger name="*" minlevel="Error" writeTo="errorfile" />
</rules>
</nlog>
TO:
<rules>
<logger name="Tray_Mac.*" minlevel="info" writeTo="TrayFile" />
<logger name="*" minlevel="trace" writeTo="file" />
<logger name="*" minlevel="Error" writeTo="errorfile" />
</rules>
</nlog>
- Navigate to /usr/local/share/CentraStage/AEMAgent/nlog.config.
- Make a copy of the nlog.config file before making any changes to it.
- Right-click on nlog.config and edit the file:
- Save and close the file.
- Restart the Datto RMM Agent. Refer to Restarting the Datto RMM Agent.
NOTE You may need to change the write permissions for the nlog.config file to allow you to edit the file and save the changes.
FROM:
<rules>
<logger name="log" minlevel="info" writeTo="log,consoleColor" />
<logger name="log" minlevel="warn" writeTo="error" />
<logger name="alert" minlevel="info" writeTo="alert" />
<logger name="poll" minlevel="info" writeTo="poll" />
<logger name="rwdetect" minlevel="debug" writeTo="rwdetectfull" />
<logger name="rwdetect" minlevel="info" writeTo="rwdetectsummary" />
<logger name="networknode" minlevel="info" writeTo="lognetworknode" />
</rules>
</nlog>
TO:
<rules>
<logger name="log" minlevel="trace" writeTo="log,consoleColor" />
<logger name="log" minlevel="warn" writeTo="error" />
<logger name="alert" minlevel="info" writeTo="alert" />
<logger name="poll" minlevel="info" writeTo="poll" />
<logger name="rwdetect" minlevel="debug" writeTo="rwdetectfull" />
<logger name="rwdetect" minlevel="info" writeTo="rwdetectsummary" />
<logger name="networknode" minlevel="info" writeTo="lognetworknode" />
</rules>
</nlog>