CLI Reference

c8volt get job

Inspect or search jobs

Synopsis

Inspect or search Camunda jobs.

Use –key with the jobKey exposed by incident-aware process-instance output to inspect a matching runtime job directly. Search mode will use list filters such as –state, –type, –pi-key, –element-instance-key, –element-id, –worker, –retries, –kind, and –listener-event-type. Search mode pages through matching jobs by default. –batch-size tunes per-page discovery requests only, –limit intentionally caps total returned jobs, and –total returns only the matching count. Use –json for the stable job payload, or –error-message-limit to shorten long error messages. Job lookup and search are supported for Camunda 8.8 and 8.9; Camunda 8.7 returns an unsupported-version error.

c8volt get job [flags]

Examples

  ./c8volt get job --key <job-key>
  ./c8volt get job --state failed --batch-size 10 --limit 50
  ./c8volt get job --state failed --total
  ./c8volt --json get job --key <job-key>

Options

  -n, --batch-size int32              number of jobs to fetch per page (max limit 1000 enforced by server) (default 1000)
      --element-id string             BPMN element ID to filter in search mode
      --element-instance-key string   element instance key to filter in search mode
      --error-message-limit int       maximum characters to show for error messages; 0 keeps full messages
  -h, --help                          help for job
      --key string                    job key for exact lookup; omit to list or search jobs
      --kind string                   Camunda job kind to filter in search mode; case-insensitive
  -l, --limit int32                   maximum number of jobs to return in search mode
      --listener-event-type string    listener event type to filter in search mode; case-insensitive
      --pi-key string                 process instance key to filter in search mode
      --retries int32                 exact retry count to filter in search mode
      --state string                  Camunda job state to filter in search mode; case-insensitive
      --total                         return only the numeric total of matching jobs
      --type string                   job type to filter in search mode
      --worker string                 worker name to filter in search mode

Options inherited from parent commands

  -y, --auto-confirm       auto-confirm prompts for non-interactive use
      --automation         enable non-interactive mode for commands that explicitly support it
      --config string      path to config file
      --debug              enable debug logging
  -j, --json               output as JSON (where applicable)
      --keys-only          output keys only (where applicable)
      --log-level string   log level (debug, info, warn, error) (default "info")
      --no-indicator       disable transient terminal activity indicators
      --profile string     config active profile name to use (e.g. dev, prod)
  -q, --quiet              suppress output except errors
      --tenant string      tenant ID for discovery/search, selection, create, deploy, and run flows; explicit keys/IDs remain backend-authorized
      --timeout duration   HTTP request timeout (default 30s)
  -v, --verbose            show additional output

SEE ALSO

  • c8volt get - Inspect cluster, process, incident, tenant, and resource state