diff --git a/docs/manage/troubleshoot/troubleshoot.md b/docs/manage/troubleshoot/troubleshoot.md index b33bc0edb8..419794282f 100644 --- a/docs/manage/troubleshoot/troubleshoot.md +++ b/docs/manage/troubleshoot/troubleshoot.md @@ -162,6 +162,21 @@ To disable this behavior, see [Disable log deduplication](/operate/reference/via To access logs from the commandline, use [`viam machines logs`](/dev/tools/cli/#machines-alias-robots) on the command line or the [Machines API](/dev/reference/apis/robot/). +### Advanced debugging for Go modules + +If you have a Go module that doesn't shut down properly or hangs during operation, you can get more information by sending a SIGQUIT signal to the process. +Run the following command, replacing `` with your module's process identifier: + +```sh {class="command-line" data-prompt="$"} +kill -3 +``` + +The process will dump a stack trace, visible in the `viam-server` logs, that shows: + +- All currently running goroutines and their states +- Where execution is blocked or deadlocked +- Internal state information that might not appear in regular logs + ## Remote shell on the machine To remotely access your machine from your terminal: