Files
coder/docs/reference/cli/logs.md
T
Cian Johnston 0f446f99dd feat(cli): add logs cmd (#21430)
This PR adds a command to view the provisioner and agent logs for a
given workspace.
Note: I did investigate using the existing `cliui` methods to tail the
logs but they are tailored to a very specific use-case.

Other changes:
- Adds `Agents` to `dbfake.WorkspaceResponse`
- Adds methods to generate provisioner and agent logs in `dbgen`

---------

Co-authored-by: Steven Masley <Emyrk@users.noreply.github.com>
2026-01-08 09:58:10 +00:00

37 lines
747 B
Markdown
Generated

<!-- DO NOT EDIT | GENERATED CONTENT -->
# logs
View logs for a workspace
## Usage
```console
coder logs [flags] <workspace>
```
## Description
```console
View logs for a workspace
```
## Options
### -n, --build-number
| | |
|---------|------------------|
| Type | <code>int</code> |
| Default | <code>0</code> |
Only show logs for a specific build number. Defaults to 0, which maps to the most recent build (build numbers start at 1). Negative values are treated as offsets—for example, -1 refers to the previous build.
### -f, --follow
| | |
|---------|--------------------|
| Type | <code>bool</code> |
| Default | <code>false</code> |
Follow logs as they are emitted.