You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: site/_wiki/Documentation/Logs.md
+15-11Lines changed: 15 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,31 +4,35 @@ title: Logs
4
4
5
5
## GUI
6
6
7
-
To view logs, click on the <kbd>Console</kbd> tab. Optionally, change filter from <kbd>Information</kbd> to <kbd>Debug</kbd> for more detailed logs.
7
+
To view the current logs, click on the <kbd>Console</kbd> tab. Optionally, change filter from <kbd>Information</kbd> to <kbd>Debug</kbd> for more detailed logs.
8
8
9
-
To export logs, click <kbd>Help</kbd> ⇒ <kbd>Export diagnostics</kbd> in the top menu bar.
9
+
You can also find previous logs in the `Logs/` folder of the application data location.
10
+
See more in the [Daemon log](#daemon-log) section.
10
11
11
-
Sometimes, the OpenTabletDriver daemon can crash hard enough that the errors can't be
12
-
sent to the GUI. In this case, you can find a
13
-
partial log in the location specified [here](#daemon-log).
12
+
To export logs, click <kbd>Help</kbd> ⇒ <kbd>Export diagnostics</kbd> in the top menu bar.
14
13
15
14
## Daemon
16
15
17
-
The output from daemon is the log.
16
+
The output from daemon is logged to the `Logs/` folder.
18
17
19
-
On Linux when running daemon via systemd service, the log for the daemon is recorded by systemd.
18
+
On Linux when running daemon via systemd service, the log for the daemon is also recorded by systemd.
20
19
To view that log, run the following command as your user:
21
20
22
21
```bash
23
22
journalctl --user-unit opentabletdriver.service
24
23
```
25
24
26
-
### Exception Log Location {#daemon-log}
25
+
### Daemon Log Location {#daemon-log}
26
+
27
+
If the daemon crashes from an "unrecoverable" exception, the error is appended to the log file.
28
+
It contains a stack trace defining where the error happened, which is useful for debugging.
29
+
30
+
Up to 20 log files will be stored in the `Logs/` folder, using the date of when the daemon started as a file name.
27
31
28
-
If the daemon crashes from an "unrecoverable" exception, the `daemon.log` file will
29
-
include a stack trace defining where the error happened, which is useful for debugging.
32
+
The log files are formatted in an almost-JSON format. It is likely they are missing the array end (`]`) which
33
+
some JSON parsers do not like. However, the format remains mostly human-readable.
30
34
31
-
The `daemon.log` file is in the application data folder, located here:
35
+
The `Logs/` folder is in the application data folder, located here:
0 commit comments