Mirrors/Sonarr
1
0
Fork 0
mirror of https://github.com/Sonarr/Sonarr.git synced 2024-11-25 04:02:48 +01:00
Code Issues Releases Wiki Activity

Updated Logging and Log Files (markdown)

Donald Webster 2019-11-12 12:51:54 -08:00
parent b50e242522
commit 538f77d9c0
1 changed files with 12 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
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
</Config>
```
### 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.
### 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.