dcos job history

Displaying the job run history

Description

The dcos job history command allows you to view your job run history.

Usage

  1. dcos job history <job-id> [--json|--quiet] [--failures --last]

Options

NameDescription
—jsonDisplay JSON-formatted list.
-q, —quietIndicates a quiet mode which results in just an array of run ids.
-f, failuresShow the failure table and statistics for history.
-l, —lastShows the last ID for history job.

Positional arguments

NameDescription
<job-id>Specify the job ID.

Examples

View the history of a job

In this example, a job history is shown.

  1. List the jobs and find the ID:

    1. dcos job list

    Here is the output:

    1. ID                DESCRIPTION                      STATUS       LAST SUCCESFUL RUN
    2. my-job            A job that sleeps                Unscheduled         N/A
    3. my-scheduled-job  A job that sleeps on a schedule  Unscheduled         N/A

  2. View the job history for my-scheduled-job:

    1. dcos job history my-scheduled-job

    Here is the output:

    1. 'my-scheduled-job'  Successful runs: 1 Last Success: 2017-02-17T23:18:33.842+0000
    2. ID                             STARTED                       FINISHED
    3. 20170217231831HkXNK  2017-02-17T23:18:31.651+0000  2017-02-17T23:18:33.843+0000

    IMPORTANT: Be sure to specify the --json option to view the JSON app definition (for example, dcos job history my-scheduled-job).

Parent command

CommandDescription
dcos jobDeploy and manage jobs in DC/OS.