mirror of
https://github.com/FoxxMD/multi-scrobbler.git
synced 2026-05-02 21:51:38 +00:00
docs: Add help docs and update github issue template with play debug data
This commit is contained in:
parent
995f857b08
commit
dee2e5ecf8
4 changed files with 90 additions and 1 deletions
71
docsite/docs/help.mdx
Normal file
71
docsite/docs/help.mdx
Normal file
|
|
@ -0,0 +1,71 @@
|
|||
---
|
||||
title: 'Help'
|
||||
---
|
||||
|
||||
## Getting Useful Data
|
||||
|
||||
### Logs
|
||||
|
||||
Multi-scrobbeler has a real-time log shown in the dashboard. These are the same logs you would find in docker logs. In the dashboard, logs can be filtered by LEVELS to give you a better view of errors/warnings.
|
||||
|
||||
When creating an issue please include all logs at the lowest level possible (DEBUG) to help provide context for your issue. You should try to include logs that occurred *before* and *after* your issue/error occurs as this can help determine if MS was behaving normally.
|
||||
|
||||
### Debug Mode
|
||||
|
||||
If possible, turn on [**Debug Mode**](/configuration#debug-mode) and replicate your issue. Debug Mode enables *much more* logging that can reveal additional data for troubleshooting.
|
||||
|
||||
This mode will make your logs very noisy, though, so it's recommended to turn it off after collecting logs.
|
||||
|
||||
### Copy Play Debug Data
|
||||
|
||||
From the dashboard, each Source/Client has a few details page links:
|
||||
|
||||
<img src={require('/img/details.jpg').default} height="400"/>
|
||||
|
||||
Opening the details page for the Source/Client reveals a lists all of the Plays that were discovered (Sources) or scrobbled (Clients).
|
||||
|
||||
Click on the Debug icon to copy debugging data relevant to that Play. This data should be included in any issue you create.
|
||||
|
||||
<img src={require('/img/debug_button.jpg').default} height="400"/>
|
||||
|
||||
To include this data in an issue either paste the copied data into a text file and save as `debugdata.json`, attaching to the issue.
|
||||
|
||||
Or directly paste the copied data into an issue/comment using [**fenced code blocks**](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks#fenced-code-blocks) markdown to preserve the structure like:
|
||||
|
||||
````
|
||||
This is the contents of my comment/issue text on github.
|
||||
|
||||
I am explaining my issue here. Here is the debug data:
|
||||
|
||||
```json
|
||||
{
|
||||
"input": {
|
||||
"aProperty: 123,
|
||||
"foo": "bar"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Thank you for your time.
|
||||
|
||||
````
|
||||
|
||||
## Finding Help
|
||||
|
||||
### FAQ
|
||||
|
||||
Check the [FAQ](/faq) to see if your issue is a known issue or a commonly-experienced issue with Multi-Scrobbler. The FAQ also includes fixes or ways to help troubleshoot these common issues.
|
||||
|
||||
### Existing Issues
|
||||
|
||||
On the github repository for Multi-Scrobbler, search [existing issues](https://github.com/FoxxMD/multi-scrobbler/issues?q=sort%3Aupdated-desc) and [discussions](https://github.com/FoxxMD/multi-scrobbler/discussions) to see if anyone else has had this issue and if it has already been solved.
|
||||
|
||||
## Reporting an Issue
|
||||
|
||||
Before reporting an issue please consider:
|
||||
|
||||
* If this a how-do-I question, troublehooting, or generally **not** a bug/error with multi-scrobbler please consider [**starting a discussion**](https://github.com/FoxxMD/multi-scrobbler/discussions) instead of opening an issue
|
||||
* If you want to request new functionality use the [**Feature Request issue** template](https://github.com/FoxxMD/multi-scrobbler/issues/new?template=02-feature-request.yml)
|
||||
* If you want to request a new Source/Client implementation use the [**New Source/Client issue** template](https://github.com/FoxxMD/multi-scrobbler/issues/new?template=03-new-source-client.yml)
|
||||
|
||||
If none of the above apply to you then create a new [**bug report**](https://github.com/FoxxMD/multi-scrobbler/issues/new?template=01-bug-report.yml). Please include all [logs](#logs) and [play debug data](#copy-play-debug-data) relevant to your issue. The more logs the better. If possible, replicate the issue with [**debug mode** turned on](#debug-mode).
|
||||
Loading…
Add table
Add a link
Reference in a new issue