251 lines
7.1 KiB
Plaintext
251 lines
7.1 KiB
Plaintext
---
|
|
layout: "docs"
|
|
page_title: "Commands: job status"
|
|
sidebar_current: "docs-commands-job-status"
|
|
description: >
|
|
Display information and status of jobs.
|
|
---
|
|
|
|
# Command: job status
|
|
|
|
The `job status` command displays status information for a job.
|
|
|
|
## Usage
|
|
|
|
```
|
|
nomad job status [options] [job]
|
|
```
|
|
|
|
This command accepts an optional job ID or prefix as the sole argument. If there
|
|
is an exact match based on the provided job ID or prefix, then information about
|
|
the specific job is queried and displayed. Otherwise, a list of matching jobs and
|
|
information will be displayed.
|
|
|
|
If the ID is omitted, the command lists out all of the existing jobs and a few of
|
|
the most useful status fields for each. As of Nomad 0.7.1, alloc status also shows allocation
|
|
modification time in addition to create time. When the `-verbose` flag is not set, allocation
|
|
creation and modify times are shown in a shortened relative time format like `5m ago`.
|
|
|
|
## General Options
|
|
|
|
<%= partial "docs/commands/_general_options" %>
|
|
|
|
## Status Options
|
|
|
|
* `-all-allocs`: Display all allocations matching the job ID, even those from an
|
|
older instance of the job.
|
|
|
|
* `-evals`: Display the evaluations associated with the job.
|
|
|
|
* `-short`: Display short output. Used only when a single node is being queried.
|
|
Drops verbose node allocation data from the output.
|
|
|
|
* `-verbose`: Show full information. Allocation create and modify times are shown in `yyyy/mm/dd hh:mm:ss` format.
|
|
|
|
## Examples
|
|
|
|
List of all jobs:
|
|
|
|
```
|
|
$ nomad job status
|
|
ID Type Priority Status Submit Date
|
|
job1 service 80 running 07/25/17 15:47:11 UTC
|
|
job2 batch 40 complete 07/24/17 19:22:11 UTC
|
|
job3 service 50 dead (stopped) 07/22/17 16:34:48 UTC
|
|
```
|
|
|
|
Short view of a specific job:
|
|
|
|
```
|
|
$ nomad job status -short job1
|
|
ID = job1
|
|
Name = Test Job
|
|
Submit Date = 07/25/17 15:47:11 UTC
|
|
Type = service
|
|
Priority = 3
|
|
Datacenters = dc1,dc2,dc3
|
|
Status = pending
|
|
Periodic = false
|
|
Parameterized = false
|
|
```
|
|
|
|
Full status information of a job:
|
|
|
|
```
|
|
$ nomad job status example
|
|
ID = example
|
|
Name = example
|
|
Submit Date = 07/25/17 15:53:04 UTC
|
|
Type = service
|
|
Priority = 50
|
|
Datacenters = dc1
|
|
Status = running
|
|
Periodic = false
|
|
Parameterized = false
|
|
|
|
Summary
|
|
Task Group Queued Starting Running Failed Complete Lost
|
|
cache 0 0 1 0 0 0
|
|
|
|
Latest Deployment
|
|
ID = 6294be0c
|
|
Status = successful
|
|
Description = Deployment completed successfully
|
|
|
|
Deployed
|
|
Task Group Desired Placed Healthy Unhealthy
|
|
cache 1 1 1 0
|
|
|
|
Allocations
|
|
ID Node ID Task Group Version Desired Status Created Modified
|
|
478ce836 5ed166e8 cache 0 run running 5m ago 5m ago
|
|
```
|
|
|
|
Full status information of a periodic job:
|
|
|
|
```
|
|
$ nomad job status example
|
|
ID = example
|
|
Name = example
|
|
Submit Date = 07/25/17 15:59:52 UTC
|
|
Type = batch
|
|
Priority = 50
|
|
Datacenters = dc1
|
|
Status = running
|
|
Periodic = true
|
|
Parameterized = false
|
|
Next Periodic Launch = 07/25/17 16:00:30 UTC (5s from now)
|
|
|
|
Children Job Summary
|
|
Pending Running Dead
|
|
0 3 0
|
|
|
|
Previously Launched Jobs
|
|
ID Status
|
|
example/periodic-1500998400 running
|
|
example/periodic-1500998410 running
|
|
example/periodic-1500998420 running
|
|
```
|
|
|
|
Full status information of a parameterized job:
|
|
|
|
```
|
|
$ nomad job status example
|
|
ID = example
|
|
Name = example
|
|
Submit Date = 07/25/17 15:59:52 UTC
|
|
Type = batch
|
|
Priority = 50
|
|
Datacenters = dc1
|
|
Status = running
|
|
Periodic = false
|
|
Parameterized = true
|
|
|
|
Parameterized Job
|
|
Payload = required
|
|
Required Metadata = foo
|
|
Optional Metadata = bar
|
|
|
|
Parameterized Job Summary
|
|
Pending Running Dead
|
|
0 2 0
|
|
|
|
Dispatched Jobs
|
|
ID Status
|
|
example/dispatch-1485411496-58f24d2d running
|
|
example/dispatch-1485411499-fa2ee40e running
|
|
```
|
|
|
|
Full status information of a job with placement failures:
|
|
|
|
```
|
|
$ nomad job status example
|
|
ID = example
|
|
Name = example
|
|
Submit Date = 07/25/17 15:55:27 UTC
|
|
Type = service
|
|
Priority = 50
|
|
Datacenters = dc1
|
|
Status = running
|
|
Periodic = false
|
|
Parameterized = false
|
|
|
|
Summary
|
|
Task Group Queued Starting Running Failed Complete Lost
|
|
cache 1 0 4 0 0 0
|
|
|
|
Placement Failure
|
|
Task Group "cache":
|
|
* Resources exhausted on 1 nodes
|
|
* Dimension "cpu" exhausted on 1 nodes
|
|
|
|
Latest Deployment
|
|
ID = bb4b2fb1
|
|
Status = running
|
|
Description = Deployment is running
|
|
|
|
Deployed
|
|
Task Group Desired Placed Healthy Unhealthy
|
|
cache 5 4 4 0
|
|
|
|
Allocations
|
|
ID Node ID Task Group Version Desired Status Created Modified
|
|
048c1e9e 3f38ecb4 cache 0 run running 5m ago 5m ago
|
|
250f9dec 3f38ecb4 cache 0 run running 5m ago 5m ago
|
|
2eb772a1 3f38ecb4 cache 0 run running 5m ago 5m ago
|
|
a17b7d3d 3f38ecb4 cache 0 run running 5m ago 5m ago
|
|
```
|
|
|
|
Full status information showing evaluations with a placement failure. The in
|
|
progress evaluation denotes that Nomad is blocked waiting for resources to
|
|
become availables so that it can place the remaining allocations.
|
|
|
|
```
|
|
$ nomad job status -evals example
|
|
ID = example
|
|
Name = example
|
|
Submit Date = 07/25/17 15:55:27 UTC
|
|
Type = service
|
|
Priority = 50
|
|
Datacenters = dc1
|
|
Status = running
|
|
Periodic = false
|
|
Parameterized = false
|
|
|
|
Summary
|
|
Task Group Queued Starting Running Failed Complete Lost
|
|
cache 1 0 4 0 0 0
|
|
|
|
Evaluations
|
|
ID Priority Triggered By Status Placement Failures
|
|
e44a39e8 50 deployment-watcher canceled false
|
|
97018573 50 deployment-watcher complete true
|
|
d5a7300c 50 deployment-watcher canceled false
|
|
f05a4495 50 deployment-watcher complete true
|
|
e3f3bdb4 50 deployment-watcher canceled false
|
|
b5f08700 50 deployment-watcher complete true
|
|
73bb867a 50 job-register blocked N/A - In Progress
|
|
85052989 50 job-register complete true
|
|
|
|
Placement Failure
|
|
Task Group "cache":
|
|
* Resources exhausted on 1 nodes
|
|
* Dimension "cpu exhausted" exhausted on 1 nodes
|
|
|
|
Latest Deployment
|
|
ID = bb4b2fb1
|
|
Status = running
|
|
Description = Deployment is running
|
|
|
|
Deployed
|
|
Task Group Desired Placed Healthy Unhealthy
|
|
cache 5 4 4 0
|
|
|
|
Allocations
|
|
ID Node ID Task Group Version Desired Status Created Modified
|
|
048c1e9e 3f38ecb4 cache 0 run running 07/25/17 15:55:27 UTC 07/25/17 15:55:27 UTC
|
|
250f9dec 3f38ecb4 cache 0 run running 07/25/17 15:55:27 UTC 07/25/17 15:55:27 UTC
|
|
2eb772a1 3f38ecb4 cache 0 run running 07/25/17 15:55:27 UTC 07/25/17 15:55:27 UTC
|
|
a17b7d3d 3f38ecb4 cache 0 run running 07/25/17 15:55:27 UTC 07/25/17 15:55:27 UTC
|
|
```
|