How to Turn On Debug and How to Increase Log Verbosity?
You got some kind of issue in MPF? A crash, weird behavior or it won't start? Then this guide is for you. You will learn how to turn up logging and how to selectively enable debugging.
1. Run MPF without text ui
The text ui which is shown by default may hide some errors and make troubleshooting more difficult. To disable text ui run mpf using:
$ mpf both -t
This will just show the log on the console. If some crashes occur this might reveal them as the text ui sometimes hides them.
2. Start MPF and MPF-MC separately
If MPF and MPF-MC logs mix up too much you can start them separately:
$ mpf game -t
And in another console:
$ mpf mc
This might help you to find out where a crash or error is originating from.
3. Increase Log Verbosity
If you experience problems you should increase verbosity:
$ mpf game -t -v -V
Start MPF-MC in a separate console:
$ mpf mc -v -V
(This will also work with
mpf both -t -v -V).
Scroll up in the console to find the error which was emitted.
This will increase the size of your logs and slow down MPF a bit. It should not be used in production but it should be fine to always use otherwise especially during development.
4. Checkout the Log Folder
MPF will generate separate logs for MPF and MPF-MC in the
in your machine. Those will also contain a bit more information than the
console. Find the issue in your log. Keep this ready for later in case
you want to report an issue.
5. Enable Debugging
If you are having an issue with a specific device or platform you should
try to enable debugging. Almost all devices and platforms in MPF support
debug option. If in doubt check the
config reference. For
instance if you suspect an issue with a switch add
debug: true to
Same works with all devices. It will generate more log lines but should not affect performance much.
Most platforms support the same. For instance with a P-Roc:
For most platforms this will generate a lot of log lines and might also affect performance a lot. We recommend to disable it after you finished debugging. See Troubleshooting Hardware Platforms for details.
After enable debug check the log again to understand what your device or platform is actually doing at the time of your issue.
Something missing or wrong? You can fix it!
This website is edited by people like you! Is something wrong or missing? Is something out of date, or can you explain it better?
Please help us! You can fix it yourself and be an official "open source" contributor!
It's easy! See our Beginner's guide to editing the docs.
Page navigation via the keyboard: < >
You can navigate this site via the keyboard. There are two modes:
General navigation, when search is not focused:
- F , S , / : open search dialog
- P , , : go to previous page
- N , . : go to next page
While using the search function:
- Down , Up : select next / previous result
- Esc , Tab : close search
- Enter : go to highlighted page in the results