Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
7919b09
docs: add guide for tracing workspace connections
coder[bot] Oct 13, 2026
645aa74
docs: drop connection path content and note Toolbox log gap
coder[bot] Oct 15, 2026
0de5621
docs: apply review feedback on trace connections guide
coder-prototypes Oct 16, 2026
421f9e9
docs: drop Coder version pins from trace connections guide
coder-prototypes Oct 16, 2026
32af7d2
docs: note when connection logs record bytes in trace connections guide
Oct 17, 2026
5c3e894
Merge branch 'main' into superblink/client-1032-trace-connections
matifali Oct 17, 2026
55c8c16
docs: correct where shutdown reasons and build fields appear in trace…
Oct 17, 2026
2653d37
docs: name Toolbox plugin v0.9.5 in trace connections guide
coder[bot] Oct 21, 2026
6e3b712
docs: address review of trace connections guide
coder[bot] Oct 22, 2026
e5ba907
Merge branch 'main' into superblink/client-1032-trace-connections
matifali Oct 25, 2026
e5a37d4
docs: align Toolbox Collect logs with support bundle requirements
matifali Oct 27, 2026
c98046a
docs: require VS Code extension 1.17.2 in trace connections guide
matifali Oct 27, 2026
caf1bb7
docs: clarify which VS Code versions lack editor names and full sessi…
matifali Oct 27, 2026
052d9e8
docs: address review feedback on connection tracing guide
matifali Oct 27, 2026
f480ff4
docs: document service log session and byte fields and agent status d…
matifali Oct 27, 2026
f1759d9
Merge branch 'main' into superblink/client-1032-trace-connections
matifali Oct 27, 2026
3a777bf
docs: clarify Toolbox logs and remove duplicate cross-reference
matifali Oct 27, 2026
04feb81
docs: remove obsolete VS Code version history
matifali Oct 27, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions docs/admin/monitoring/connection-logs.md
Original file line number Diff line number Diff line change
Expand Up @@ -150,6 +150,11 @@ Each `connection_log` entry describes the connection with these fields:
- `ConnectionMethod`: How the connection was established, with the same values as the API `connection_method` field.
- `AppNameOrPort`: The name of the connecting application for SSH and reconnecting PTY connections, or the workspace app slug or forwarded port for workspace app and port forwarding connections.
The value is an empty string when there is nothing to report.
- `ClientSessionID`: The client session ID for SSH and reconnecting PTY connections, or an empty string.
To follow a session across client, `coderd`, and agent logs, refer to [Trace workspace connections](./trace-connections.md).
- `RxBytes` and `TxBytes`: The bytes the agent received and sent over an SSH or reconnecting PTY connection.
They're set only on `disconnected` entries, and are `null` (`<nil>` in human-readable logs) otherwise or for older agents.
They aren't in the API or the dashboard.

If your log pipeline reads the `Type` or `SlugOrPort` fields, update it to read `ConnectionMethod` and `AppNameOrPort`, because entries no longer include the old fields.
For SSH connections from a VS Code or JetBrains family app, `ConnectionMethod` is `ssh` and `AppNameOrPort` holds the app name, such as `vscode`.
Expand Down
Loading
Loading