Editing Server logs
From FileZilla Wiki
Jump to navigationJump to searchWarning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
| Latest revision | Your text | ||
| Line 1: | Line 1: | ||
[[Category:Documentation]] | [[Category:Documentation]] | ||
| + | Note: Work in progress! | ||
= Logging in FileZilla Server = | = Logging in FileZilla Server = | ||
FileZilla Server, like the client, includes two means of logging, screen and file log. | FileZilla Server, like the client, includes two means of logging, screen and file log. | ||
| Line 7: | Line 8: | ||
The screen log is enabled automatically when the admin interface is running, you don't have to do anything more. | The screen log is enabled automatically when the admin interface is running, you don't have to do anything more. | ||
| − | If you want logs | + | If you want logs if no user is logged on, don't want to leave the admin interface running or want to track large logs, you need to use file logging (see below). |
=== What is logged (older FileZilla Server) === | === What is logged (older FileZilla Server) === | ||
* Connection ID (in brackets): every new connection will get a unique ID, this aids in tracking one special connection only<br> | * Connection ID (in brackets): every new connection will get a unique ID, this aids in tracking one special connection only<br> | ||
* Time stamp | * Time stamp | ||
| − | * User name of the account using this connection, '''(not logged in)''' is shown before the login process is completed.<br> | + | * User name of the account using this connection, '''(not logged in)''' is shown before the '''login''' process is completed.<br> |
* IP of the initiator of the connection | * IP of the initiator of the connection | ||
* The separator ><br> | * The separator ><br> | ||
| Line 73: | Line 74: | ||
=== Setting up file log === | === Setting up file log === | ||
| − | Open the server settings | + | Open the server settings and navigate to the 'Logging' tab. Tick the 'Enable logging to file' box and you're done. The logfiles are stored into a 'Logs' subdirectory of FileZilla Servers installation path. This location cannot be changed. |
=== Limiting the log size === | === Limiting the log size === | ||
| Line 79: | Line 80: | ||
=== Daily logfile rotation === | === Daily logfile rotation === | ||
| − | You can either log everything into one big file, or let the server create a new logfile every day. Just enable 'Use a different logfile each day', and FileZilla Server will create logs in the format '''fzs- | + | You can either log everything into one big file, or let the server create a new logfile every day. Just enable 'Use a different logfile each day', and FileZilla Server will create logs in the format '''fzs-yyyy-mm-dd.log'''.<br> |
The timestamp in the logfile name follows ISO8601 (four digit year, then month, then day), so the logs will sort correctly. Additionally you can set the number of days for which logfiles are kept. Enable 'Delete old logfiles after' and put the desired value (in days) into the field. | The timestamp in the logfile name follows ISO8601 (four digit year, then month, then day), so the logs will sort correctly. Additionally you can set the number of days for which logfiles are kept. Enable 'Delete old logfiles after' and put the desired value (in days) into the field. | ||
=== Special case: Using log size limit and rotating logfiles together === | === Special case: Using log size limit and rotating logfiles together === | ||
There is one effect when using these two features together which may confuse many users because it works differently as expected.<br> | There is one effect when using these two features together which may confuse many users because it works differently as expected.<br> | ||
| − | '''When enabling a logfile size limit with daily rotating logs, the limit does not apply to every file, but to all files together!''' | + | '''When enabling a logfile size limit with daily rotating logs, the limit does not apply to every days file, but to all files together!''' |
| − | Example: You enabled a size limit of 100MB, daily logs and deleting logfiles after 10 days. All 10 logfiles together may not exceed 100MB, so you could have 10 logfiles of | + | Example: You enabled a size limit of 100MB, daily logs and deleting logfiles after 10 days. All 10 logfiles together may not exceed 100MB, so you could have 10 logfiles of 1MB each. |
= See also = | = See also = | ||
[[Logs|Logging in FileZilla Client]] | [[Logs|Logging in FileZilla Client]] | ||
