docs: add troubleshooting section to JetBrains Toolbox docs (#18394)

matifali · web-flow · commit 9c1feffdedc7 · 2025-06-20T20:00:56.000+05:00
diff --git a/docs/user-guides/workspace-access/jetbrains/toolbox.md b/docs/user-guides/workspace-access/jetbrains/toolbox.md
@@ -55,3 +55,29 @@ To connect to a Coder deployment that uses internal certificates, configure the
 1. Select **Settings**.
 1. Add your certificate path in the **CA Path** field.
    ![JetBrains Toolbox Coder Provider certificate path](../../../images/user-guides/jetbrains/toolbox/certificate.png)
+
+## Troubleshooting
+
+If you encounter issues connecting to your Coder workspace via JetBrains Toolbox, follow these steps to enable and capture debug logs:
+
+### Enable Debug Logging
+
+1. Open Toolbox
+1. Navigate to the **Toolbox App Menu (hexagonal menu icon) > Settings > Advanced**.
+1. In the screen that appears, select `DEBUG` for the Log level: section.
+1. Hit the back button at the top.
+1. Retry the same operation
+
+### Capture Debug Logs
+
+1. Access logs via **Toolbox App Menu > About > Show log files**.
+2. Locate the log file named `jetbrains-toolbox.log` and attach it to your support ticket.
+3. If you need to capture logs for a specific workspace, you can also generate a ZIP file using the Workspace action menu, available either on the main Workspaces page in Coder view or within the individual workspace view, under the option labeled **Collect logs**.
+
+> [!Workspace]
+> Toolbox does not persist log level configuration between restarts.
+
+## Additional Resources
+
+- [JetBrains Toolbox documentation](https://www.jetbrains.com/help/toolbox-app)
+- [Coder JetBrains Toolbox Plugin Github](https://github.com/coder/coder-jetbrains-toolbox)
