Agent log files

The Datto RMM log files are text files created by Datto RMM that contain a detailed record of events in the Datto RMM Agent. These log files are used for Agent troubleshooting and diagnosis.

Separate log files are created for the main Datto RMM Agent Service and the Datto RMM Agent Process. The location and behavior of the log files varies per operating system.

The Datto RMM Agent Process (AEMAgent.exe, introduced as part of the AEM 2017-1 release) is a child process of the main Datto RMM Agent Service (CagService) and is dedicated solely to performing endpoint monitoring tasks. Audit and other data submissions are performed by the main Datto RMM Agent Service.

The following information is applicable to Agent version 4.4.1986.1986 and above. For further information about Agent requirements, refer to Supported operating systems and Agent requirements.

Location of the log files

Operating System Datto RMM Agent Service Datto RMM Agent Process
Windows Log location
• 32-bit version of Windows - %ProgramFiles%\CentraStage\log.txt
• 64-bit version of Windows - %ProgramFiles(x86)%\CentraStage\log.txt

Notes
• Daily at midnight, the current log.txt file is moved to a directory named archives in the log location and logging begins a new file.
• The archive log files have the following naming convention log.[number].txt (i.e. log.0.txt).
• The most recent archive log file is log.0.txt with older files having incrementing numbers moving back in time.
• A maximum of 7 days' logs are archived (log.0.txt - log.6.txt).
• Upon Agent uninstallation, the current log file is moved to %ProgramData%\CentraStage\Logs with a prepended time stamp in the format yyyyMMddHmmss (i.e. 2017060185607_log.txt). The archive log files are not moved to this location upon Agent uninstallation. This behavior is only present for Agents newly downloaded (not updated) since version 4.4.1904.1904.
Log location
%ProgramData%\CentraStage\AEMAgent\DataLog\aemagent.log


Notes
• Daily at midnight, or if it grows larger than 10 MB, the current aemagent.log file is moved to a directory named Archives in the log location and logging begins a new file.
• The archive log files have the naming convention [date].[number].aemagent.log (i.e. 20170704.0.aemagent.log) with a date stamp in the format yyyyMMdd and a number indicating the correct order.
• The most recent archive log file will have the highest number, while the oldest archive log file will have the smallest number (starting from 0).
• A maximum of 30 days' logs are archived.
• Upon Agent uninstallation, all log files remain untouched.
macOS Log location
/var/log/AEMAgentlog.txt

Notes
• Daily at midnight, the current AEMAgentlog.txt file is renamed with the following naming convention AEMAgentlog.[number].txt (i.e. AEMAgentlog.0.txt) and logging begins a new file.
• The most recent archive log file is AEMAgentlog.0.txt with older files having incrementing numbers moving back in time.
• A maximum of 7 days' logs are archived (AEMAgentlog.0.txt - AEMAgentlog.6.txt).
• Upon Agent uninstallation, all log files are removed.
Log location
/usr/local/share/CentraStage/AEMAgent/DataLog/aemagent.log

Notes
• Daily at midnight, or if it grows larger than 10 MB, the current aemagent.log file is moved to a directory named Archives in the log location and logging begins a new file.
• The archive log files have the naming convention [date].[number].aemagent.log (i.e. 20170704.0.aemagent.log) with a date stamp in the format yyyyMMdd and a number indicating the correct order.
• The most recent archive log file will have the highest number, while the oldest archive log file will have the smallest number (starting from 0).
• A maximum of 30 days' logs are archived.
• Upon Agent uninstallation, all log files remain untouched.
Linux Log location
/opt/CentraStage/log.txt

Notes
• Daily at midnight, the current log.txt file is moved to a directory named archives in the log location and logging begins a new file.
• The archive log files have the following naming convention log.[number].txt (i.e. log.0.txt).
• The most recent archive log file is log.0.txt with older files having incrementing numbers moving back in time.
• A maximum of 7 days' logs are archived (log.0.txt - log.6.txt).
• Upon Agent uninstallation, all log files are removed.
Log location
/usr/local/share/CentraStage/AEMAgent/DataLog/aemagent.log

Notes
• Daily at midnight, or if it grows larger than 10 MB, the current aemagent.log file is moved to a directory named Archives in the log location and logging begins a new file.
• The archive log files have the naming convention [date].[number].aemagent.log (i.e. 20170704.0.aemagent.log) with a date stamp in the format yyyyMMdd and a number indicating the correct order.
• The most recent archive log file will have the highest number, while the oldest archive log file will have the smallest number (starting from 0).
• A maximum of 30 days' logs are archived.
• Upon Agent uninstallation, all log files remain untouched.

 

Need to troubleshoot this? Open the Datto Knowledge Base.
Want to talk about it? Head on over to our Community Forum!
Forward this topic to others.
Provide feedback for the Documentation team.