From ae0a3993db9928db382e2370a3817f785f76b577 Mon Sep 17 00:00:00 2001 From: Athanasius Date: Mon, 21 Sep 2020 09:20:30 +0100 Subject: [PATCH] Troubleshooting: Detail new rotated DEBUG log files. --- Troubleshooting.md | 31 ++++++++++++++++++++++--------- 1 file changed, 22 insertions(+), 9 deletions(-) diff --git a/Troubleshooting.md b/Troubleshooting.md index d13a490..58d926c 100644 --- a/Troubleshooting.md +++ b/Troubleshooting.md @@ -226,17 +226,30 @@ If your configuration has been corrupted, or badly set, such that you can't run -- # Reporting a problem -Please report a problem as a new GitHub [issue](https://github.com/EDCD/EDMarketConnector/issues/new?assignees=&labels=bug%2C+unconfirmed&template=bug_report.md&title=) -. Please wait for the error to occur and zip up and attach this app's log file to the new issue: +Please report a problem as a new GitHub [issue](https://github.com/EDCD/EDMarketConnector/issues/new?assignees=&labels=bug%2C+unconfirmed&template=bug_report.md&title=). +. -Mac: +## 4.1.0 and later (including betas) +If you are using 4.1.0, or later (including betas of 4.1.0) then there is a new +set of rotated logfiles in the location: -* `$TMPDIR/EDMarketConnector.log` +* Windows: `%TMP%\EDMarketConnector\EDMarketConnector.log` +* Mac: `$TMPDIR/EDMarketConnector/EDMarketConnector.log` +* Linux: `$TMPDIR/EDMarketConnector/EDMarketConnector.log` -Windows: +These are *not* truncated on a new run, so there will be no need to re-create +the bug. They are, however, rotated (to `EDMarketConnector.log.1` and onwards) +if they reach 1 MiB in size. So check timestamps and contents to be sure you +upload the correct file! -* `%TMP%\EDMarketConnector.log` +These files also *always* contain DEBUG output, +whereas the file detailed below only contains raw `print()` output and anything +logged at the level you have configured. -**NB: This file is truncated (overwritten from the start) each time you -run the appication. So if you encounter an error make a copy of this -file *immediately*.** +## Pre-4.1.0 +Prior to EDMC 4.1.0 the only logfile is re-created on each run of the program. +As such you will need to re-create the issue and then make a copy of the file: + +* Windows: `%TMP%\EDMarketConnector.log` +* Mac: `$TMPDIR/EDMarketConnector.log` +* Linux: `$TMPDIR/EDMarketConnector.log`