From 538f77d9c00ef77337857c83ce9a155032d54520 Mon Sep 17 00:00:00 2001 From: Donald Webster Date: Tue, 12 Nov 2019 12:51:54 -0800 Subject: [PATCH] Updated Logging and Log Files (markdown) --- Logging-and-Log-Files.md | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/Logging-and-Log-Files.md b/Logging-and-Log-Files.md index 7496659..51df37b 100644 --- a/Logging-and-Log-Files.md +++ b/Logging-and-Log-Files.md @@ -1,9 +1,9 @@ -### Location ### +### Location The log files are located in Sonarr's [AppData directory](https://github.com/Sonarr/Sonarr/wiki/AppData-Directory), inside the `logs/` folder. You can also access the log files from the Sonarr UI at System -> Logs -> Files. **Note**: the Logs Table in the UI is _not_ the same as the log files. -### Trace/Debug Logs ### +### Trace/Debug Logs You can change the log level at Settings -> General -> Logging. Sonarr 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 `sonarr.debug.txt` and `sonarr.trace.txt` respectively. [[images/Settings.General.Logging.v3.png]] @@ -18,10 +18,15 @@ If you're unable to access the Sonarr UI to set the logging level you can do so ``` -### Clearing Logs ### +### 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 ### -Sonarr uses rolling log files, each one limited to 1MB in size. The current log file is always `sonarr.txt`, for the the other files `sonarr.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 `sonarr.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 `sonarr.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 +### Multiple Log Files +Sonarr uses rolling log files limited to 1MB each. The current log file is always `sonarr.txt`, for the the other files `sonarr.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 `sonarr.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 `sonarr.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. + +### Sharing Logs +The log files can be long and hard to read as part of a forum or reddit post. And they're spammy in IRC or Discord, so *please* use a [pastebin](https://paste.ubuntu.com). The whole file typically isn't needed, just a good amount of context around the issue/error. Don't forget to wait for spammy tasks to finish, like the RSS sync or library refresh. \ No newline at end of file