Jobs

Jobs are long-running server-side operations that Chronicle executes asynchronously. Common examples include observer replays, index rebuilds, and partition recovery operations. Chronicle tracks each job’s progress, individual steps, and final status. Jobs may be stopped, resumed, and inspected while they are running or after they complete.

list

Lists all jobs in the specified event store and namespace, including both running and completed jobs.

cratis chronicle jobs list

Options

Flag	Description
`-e, --event-store <NAME>`	Event store to inspect. Defaults to `default`.
`-n, --namespace <NAME>`	Namespace to inspect. Defaults to `Default`.

Examples

List all jobs:

cratis chronicle jobs list

List jobs in plain format:

cratis chronicle jobs list --output plain

Get job IDs for scripting:

cratis chronicle jobs list -q

get

Shows full details for a single job, including all steps, their individual progress, and any error information.

cratis chronicle jobs get <JOB_ID>

Arguments

Argument	Description
`JOB_ID`	The GUID of the job. Use `jobs list -q` to retrieve job IDs.

Options

Flag	Description
`-e, --event-store <NAME>`	Event store to inspect. Defaults to `default`.
`-n, --namespace <NAME>`	Namespace to inspect. Defaults to `Default`.

Examples

Show job details:

cratis chronicle jobs get a1b2c3d4-e5f6-7890-abcd-ef1234567890

Get the full job document as JSON:

cratis chronicle jobs get a1b2c3d4-e5f6-7890-abcd-ef1234567890 -o json

resume

Resumes a stopped or failed job, allowing it to continue from where it left off.

cratis chronicle jobs resume <JOB_ID>

Arguments

Argument	Description
`JOB_ID`	The GUID of the job to resume.

Options

Flag	Description
`-e, --event-store <NAME>`	Event store. Defaults to `default`.
`-n, --namespace <NAME>`	Namespace. Defaults to `Default`.

Examples

Resume a stopped job:

cratis chronicle jobs resume a1b2c3d4-e5f6-7890-abcd-ef1234567890

stop

Stops a running job. The job’s progress is preserved and the job can be resumed later.

cratis chronicle jobs stop <JOB_ID>

Arguments

Argument	Description
`JOB_ID`	The GUID of the job to stop.

Options

Flag	Description
`-e, --event-store <NAME>`	Event store. Defaults to `default`.
`-n, --namespace <NAME>`	Namespace. Defaults to `Default`.

Examples

Stop a running job:

cratis chronicle jobs stop a1b2c3d4-e5f6-7890-abcd-ef1234567890

Check the job status after stopping:

cratis chronicle jobs get a1b2c3d4-e5f6-7890-abcd-ef1234567890 -o json