logs

cpln logs — Query and display logs from workloads and other Control Plane resources.

Show logs

For a detailed overview, please visit the logs’ reference page.

Usage

cpln logs <query> [OPTIONS]

The <query> positional requires a valid LogQL string enclosed within single quotes.

Available query labels: gvc, workload, container, location, provider, replica, stream

Reference

Command options:
  --tail, -t, -f  Tail the logs (follow)  [boolean]
  --limit         Maximum number of log entries to return. Use 0 for unlimited (auto-paginates through the full time range)  [number] [default: 30]
  --delay-for     Delay in tailing by number of seconds to accumulate logs for re-ordering  [number] [default: 0]
  --since         Lookback window  [default: "1h"]
  --from          Start looking for logs at this absolute time (inclusive)
  --to            Stop looking for logs at this absolute time (exclusive)
  --output, -o    Specify output mode. raw suppresses log labels and timestamp  [choices: "default", "raw", "jsonl"] [default: "default"]
  --direction     Sort order of logs  [choices: "forward", "backward"] [default: "forward"]

Positionals:
  query  LogQL query  [required]

Context options:
  --profile  Override the profile. The default profile can be set using the `cpln profile set-default` command or by setting the CPLN_PROFILE environment variable
  --org      Override the organization. The default organization can be set in your profile by using the `cpln profile update` command

Request options:
  --token         Override the authorization token
  --endpoint      Override the API URL
  --insecure, -k  Ignore TLS errors  [boolean]

Debug options:
  --verbose, -v  Enable verbose output to stderr  [boolean] [default: false]
  --debug, -d    Show all HTTP communications  [boolean] [default: false]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

Common Options Reference

Example

Command

cpln logs '{gvc="demo-gvc-logs",workload="demo-workload-logs"}'

Command

cpln logs '{provider="aws"}'

---