- Docs
- On-Premise
- On-Premise Agent
- Agent Logs
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.