Skip to main content
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
Command options:
  --tail, -t, -f  Tail the logs (follow)  [boolean]
  --limit         Limit on number of entries to show  [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
cpln logs '{gvc="demo-gvc-logs",workload="demo-workload-logs"}'
cpln logs '{provider="aws"}'