9acfa166c0
The Superset method on Resources used to return a string in the format of “[resource name] exhausted”.
This was leading to the output in plan/create job API DimensionExhausted to return keys like
```
"DimensionExhausted": {"cpu exhausted": 1}
```
This was not anywhere documented, however, one of the examples on the website showed it like this.
The other side effect of this is that the CLI formats the strings from the name of the key leading to output like
```
* Dimension "cpu exhausted" exhausted on 1 nodes
```
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 perodic 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
|
|
```
|