Skip to main content

logs

view deployment logs (runtime, build, or deploy)

📜 View a deployment's logs.

Three kinds, via --kind: • runtime — your application's stdout/stderr (the default) • build — the build output for a deploy version, or one build (--build) • deploy — rollout events (provisioning, scaling, image pull, live, …)

By default it prints the most recent lines and exits. Use --follow (-f) to stream live — runtime logs only. --tail sets how many recent lines to fetch, --since limits by age (e.g. 1h, 30m), and --timestamps prefixes each line.

--search (-q) filters to lines matching a free-text term (case-insensitive). For fetched logs the search runs server-side; with --follow it filters the live tail.

--build <build-id> prints that build's output (ids from csph deployment builds list). A finished build is replayed in full; a running one is followed until it ends. --tail and --since don't apply to it.

Logs are sanitized at the server, so they never expose internal infrastructure detail.

Usage​

csph deployments logs <deployment-id> [flags]

Options​

Command Specific​

--account <string>
account ID
--build <string>
build id: that build's output, followed live while it runs (implies --kind build)
--deploy-version <string>
deploy version id for --kind build (default: latest)

-f, --follow

stream logs live (runtime only)

--kind <string> (default "runtime")

log kind: [runtime|build|deploy]
--output <string>
output format: [json]

-q, --search <string>

only show lines matching this free-text filter (case-insensitive)
--since <duration>
only logs newer than a duration, e.g. 1h or 30m

-n, --tail <int> (default 200)

number of recent lines to fetch
--timestamps
prefix each line with its timestamp

Inherited​

--config <string>
config file (default is $HOME/.config/computesphere/configuration.yaml)
--debug
enable debug logging

-h, --help

show this help message

-i, --interactive

run interactively (prompts, pickers, table browser)
--log-level <string>
log level: [trace|debug|info|warn|error|fatal|panic|disabled||api]
--no-color
disable color output
--no-input
disable interactive mode

Examples​

# last 200 runtime lines
> csph deployment logs <deployment-id>

# stream runtime logs live (Ctrl-C to stop)
> csph deployment logs <deployment-id> --follow

# last hour of runtime logs, with timestamps
> csph deployment logs <deployment-id> --since 1h --timestamps

# search the logs (server-side, case-insensitive)
> csph deployment logs <deployment-id> --search "timeout"
> csph deployment logs <deployment-id> -q "/health" --since 1h

# rollout / deploy events
> csph deployment logs <deployment-id> --kind deploy

# build output for the latest deploy
> csph deployment logs <deployment-id> --kind build

# output of one build (follows it live while it runs)
> csph deployment logs <deployment-id> --build <build-id>

See also​