Seek Assistance

For help with HoyoShip, and to report a bug, contact Dorico Dynamics at support@doricod.com.

Note

When asking for support, it may be a good idea to have the following available so that the person helping has all the info they need:

1. Your HoyoShip version (see HoyoShip version numbers).

2. Your app.ini (with any sensitive data scrubbed as necessary).

3. The HoyoShip logs, and any other appropriate log files for the situation.

   • On Kubernetes, use kubectl logs --tail 1000 <hoyoship-pod> to collect logs.
   • When using docker, use docker logs --tail 1000 <hoyoship-container> to collect logs.
   • By default, the logs are outputted to console. If you need to collect logs from files, you could copy the following config into your app.ini (remove all other [log] sections), then you can find the *.log files in HoyoShip’s log directory (/var/lib/gitea/data/log in the HoyoShip image).

   ; To show all SQL logs, you can also set LOG_SQL=true in the [database] section
   [log]
   LEVEL=debug
   MODE=console,file
   ROUTER=console,file
   XORM=console,file
   ENABLE_XORM_LOG=true
   FILE_NAME=hoyoship.log
   [log.file.router]
   FILE_NAME=router.log
   [log.file.xorm]
   FILE_NAME=xorm.log

4. Any error messages you are seeing.

5. If you meet slow/hanging/deadlock problems, please report the stack trace when the problem occurs:

   1. Enable pprof in app.ini and restart HoyoShip.

      [server]
      ENABLE_PPROF = true

   2. Trigger the bug, and when HoyoShip gets stuck, use curl or browser to visit: http://127.0.0.1:6060/debug/pprof/goroutine?debug=1 (IP must be 127.0.0.1 and port must be 6060).

   3. If you are using Docker, please use docker exec -it <container-name> curl "http://127.0.0.1:6060/debug/pprof/goroutine?debug=1".

   4. Report the output (the stack trace doesn’t contain sensitive data).