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

  1. On your device, navigate to the nlog.config file:
    2. 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.

  2. Make a copy of the nlog.config file before making any changes to it.
  3. Right-click on nlog.config and edit the file:

    4. FROM:

    logger name="*" minlevel="Info" writeTo="file" />

    TO:

    logger name="*" minlevel="Trace" writeTo="file" />
  4. Save and close the file.
  5. Restart the Datto RMM Agent. Refer to Restarting the Datto RMM Agent.

Now, when you view the Log.txt file, the extra lines containing DEBUG information will appear.

  1. Navigate to %ProgramData% > CentraStage > AEMAgent > nlog.config.

    2. 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.

  2. Make a copy of the nlog.config file before making any changes to it.
  3. Right-click on nlog.config and edit the file:

    4. 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>
  4. Save and close the file.
  5. Restart the Datto RMM Agent. Refer to Restarting the Datto RMM Agent.

macOS

  1. Navigate to Applications > AEM Agent.app > Contents > Resources > nlog.config.

    2. 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.

  2. Make a copy of the nlog.config file before making any changes to it.
  3. Right-click on nlog.config and edit the file:

    4. 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>
  4. Save and close the file.
  5. Restart the Datto RMM Agent. Refer to Restarting the Datto RMM Agent.
  1. Navigate to /usr/local/share/CentraStage/AEMAgent/nlog.config.

    2. 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.

  2. Make a copy of the nlog.config file before making any changes to it.
  3. Right-click on nlog.config and edit the file:

    4. 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>
  4. Save and close the file.
  5. Restart the Datto RMM Agent. Refer to Restarting the Datto RMM Agent.