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.

Ready to Transform Your File Infrastructure?

Join over 4,000 organizations that trust Files.com to manage their mission-critical file flows. Start your free trial today and see why we're the #1 rated file orchestration platform.

No credit card required • 7-day free trial • Setup in minutes