Skip to main content

Agent Logs

All actions performed within Agent Remote Server folders are stored in the corresponding logs in exactly the same way as all other types of Remote Server and History actions are logged.

The Agent also produces a local log file on the host system. The local log file contains information about the specific actions that the Agent attempted to perform while responding to instructions from your Files.com site. This log file can be shared with our Support team when troubleshooting.

Log File Location

When the Agent is run as a Windows service, the log file is named files-agent.log and will be located in the C:\Program Files\Files.com-Agent folder.

When the Agent is run as a Linux or Mac service, the log file is named files-agent.log and will be located in the same folder that Agent was in when the service was installed.

Automatic Log Rotation

By default, the Agent log file will be automatically rotated whenever it reaches 20MB in size and 5 copies of the rotated logs will be retained.

Log Configuration Options

Update the log related settings in the Agent configuration file to change the rotation size, the number of retained copies, and the location of the log file.

Specifying Log Location During Troubleshooting

Always run the Agent as a system service. However, during troubleshooting, the Agent can be run manually to verify connectivity and functionality.

When the Agent is run manually, the log file is named files-agent.log and will be located in the same folder that Agent resides in. You can specify the location of the log file by using the --log_file option:

files-agent.exe start --config C:\path\to\files_agent_config.toml --log_file C:\path\to\outputfile.log

After troubleshooting has been completed, install the Agent as a system service.

Get Instant Access to Files.com

The button below will take you to our Free Trial signup page. Click on the white "Start My Free Trial" button, then fill out the short form on the next page. Your account will be activated instantly. You can dive in and start yourself or let us help. The choice is yours.