history

Output job event history for all vault elements. This is useful when debugging issues with automated scripts or CI builds. The job events will be sorted by vault element and then by status-time.

usage: cmri job history [--start-time <start_time>] [--end-time <end_time>] [--completion-only]

optional arguments:

-S, --start-time

Returns job history events with a status time greater-than or equal-to this time. For argument value, use YYYY-MM-DD HH:MM (24 hour format) or MM/DD/YYYY HH:MM am/pm (12 hour format). You may also enter time in epochal milliseconds (e.g. 1573174471667).

-e, --end-time

Returns job history events with a status time less-than or equal-to this time. For argument value, use YYYY-MM-DD HH:MM (24 hour format) or MM/DD/YYYY HH:MM am/pm (12 hour format). You may also enter time in epochal milliseconds (e.g. 1573174471667).

-c, --completion-only

Returns job history events with a status equal to complete.

Output Fields

target

The identifier of the system vault element in the format <project_name>/<system_name-version> or the project vault element in the format <project_name>. The target for vault-level jobs will be blank.

job_name

The name of the job event that occurred.

user

The identifier of the user that ran this job event in the format <user_name>@<host_name>.

status_time

The time that the job event was run in the format YYYY-MM-DD HH:MM or epochal milliseconds (e.g. 1573174471667).

status

The status of the job event.

  • init: The job runner has initialized its variables and is ready to begin executing jobs.

  • started: Job execution has begun.

  • complete: The job runner has finished executing jobs.

  • passed: Job execution has completed successfully.

  • skipped: The job was skipped because it was either not applicable to the given target, or the job determined that it should be skipped.

  • failed: The job has reported that execution failed.

  • error: An unexpected error either during job setup, or job execution, and the job cannot continue running.

flags

The list of arguments that were passed into the job event.