From 95f65deed5474f4b18cbadc07c9db57f53722315 Mon Sep 17 00:00:00 2001 From: Qstick Date: Thu, 2 Nov 2017 20:43:38 -0400 Subject: [PATCH] Created Log Files (markdown) --- Log-Files.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 Log-Files.md diff --git a/Log-Files.md b/Log-Files.md new file mode 100644 index 0000000..92b110f --- /dev/null +++ b/Log-Files.md @@ -0,0 +1,18 @@ +_By default log files are Info level logs, if debug or trace logs are required you need to enable them in settings first._ + +### Location ### +The location of the log files depends where Lidarr's [AppData directory](https://github.com/Lidarr/Lidarr/wiki/AppData-Directory) is located, the log files will be inside the logs folder. You can also access the log files from the Lidarr UI (System: Logs: Files). +**Note**: the Logs Table in the UI is _not_ the same as the log files. + +### Trace/Debug Logs ### +You can enable Trace or Debug logging in Settings on the General tab, by setting the `Log Level`. Lidarr does not need to restarted for the change to take effect. This change only effects the log files, not the logging database. The latest debug/trace log files are named `lidarr.debug.txt` and `lidarr.trace.txt` respectively. + +If you're unable to access the Lidarr UI to set the logging level you can do so by editing `config.xml` in the [AppData directory](https://github.com/Lidarr/Lidarr/wiki/AppData-Directory) by setting the `LogLevel` value to `Debug` or `Trace` instead of `Info`. + +### Clearing Logs ### +You can clear log files and the logs database directly from the UI, under System -> Logs -> Files and System -> Logs respectively. + +### Multiple Log Files ### +Lidarr uses rolling log files, each one limited to 1MB in size. The current log file is always `lidarr.txt`, for the the other files `lidarr.0.txt` is the next newest (the higher the number the older it is) up to 6 log files total. This log file contains fatal,error,warn and info entries. +When Debug log level is enabled, additional `lidarr.debug.txt` rolling log files will be present, up to 51 files. This log files contains fatal,error,warn,info and debug entries. It usually covers a 40h period. +When Trace log level is enabled, additional `lidarr.trace.txt` rolling log files will be present, up to 51 files. This log files contains fatal,error,warn,info,debug and trace entries. Due to trace verbosity it only covers a couple of hours. \ No newline at end of file