Neptune 3 UI - Troubleshoot

Neptune 3 UI provides logs that you can use to investigate issues that may arise. These logs can be configured via Qt's Logging Category System. In addition to controlling the categories using the QT_LOGGING_RULES environment variable and the global qtlogging.ini, the QtApplicationManager, which is Neptune 3 UI's base, also allows you to define these categories as part of the am-config.yaml file.

Note: On embedded systems, Neptune 3 UI is started with systemd. Here, you can control the categories using environment variables or custom command-line arguments, via the neptune.service file.

Recreate the Application Database

In the event that some of the Apps in Neptune 3 UI happen to be missing information, you can restore the application database to its initial state. To do so, launch Neptune 3 UI with the following command in your terminal:

./neptune3-ui -r

View Logs after a Crash

In the event of a crash, Neptune 3 UI prints a C++ stack trace or a QML stack trace to provide details on what went wrong. This information is printed in stderr. To retrieve more context on the cause of the crash, it's helpful to run Neptune 3 UI with complete logs enabled, using the --verbose command-line option.

On embedded systems, Neptune 3 UI is started with systemd. All console output is automatically collected and can be retrieved using journalctl:

journalctl -u neptune

The Neptune 3 UI binary is a custom built QtApplicationManager, and as such, supports all of QtApplicationManager's command-line and configuration options, as described in Configuration. For more details on how to troubleshoot QtApplicationManager issues, see Troubleshoot.

© 2018 Pelagicore AG. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.