2015-09-15 03:24:04 +00:00
|
|
|
---
|
|
|
|
layout: "docs"
|
|
|
|
page_title: "Commands: status"
|
|
|
|
sidebar_current: "docs-commands-status"
|
|
|
|
description: >
|
|
|
|
Display information and status of jobs.
|
|
|
|
---
|
|
|
|
|
|
|
|
# Command: status
|
|
|
|
|
|
|
|
The `status` command displays status information for jobs.
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
```
|
|
|
|
nomad status [options] [job]
|
|
|
|
```
|
|
|
|
|
2015-10-26 19:59:47 +00:00
|
|
|
This command accepts an optional job ID as the sole argument. If the job ID is
|
2015-09-15 03:24:04 +00:00
|
|
|
provided, information about the specific job is queried and 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.
|
|
|
|
|
|
|
|
## General Options
|
|
|
|
|
2015-09-15 20:39:57 +00:00
|
|
|
<%= general_options_usage %>
|
2015-09-15 03:24:04 +00:00
|
|
|
|
2015-09-15 20:09:47 +00:00
|
|
|
## Status Options
|
|
|
|
|
|
|
|
* `-short`: Display short output. Used only when a single node is being queried.
|
|
|
|
Drops verbose node allocation data from the output.
|
|
|
|
|
2015-09-15 03:24:04 +00:00
|
|
|
## Examples
|
|
|
|
|
2015-09-15 20:09:47 +00:00
|
|
|
List of all jobs:
|
2015-09-15 03:24:04 +00:00
|
|
|
|
|
|
|
```
|
|
|
|
$ nomad status
|
|
|
|
ID Type Priority Status
|
|
|
|
job1 service 3 pending
|
|
|
|
job2 service 3 running
|
|
|
|
job3 service 2 pending
|
|
|
|
job4 service 1 complete
|
|
|
|
```
|
|
|
|
|
2015-09-15 20:09:47 +00:00
|
|
|
Short view of a specific job:
|
|
|
|
|
|
|
|
```
|
|
|
|
$ nomad status -short job1
|
|
|
|
ID = job1
|
|
|
|
Name = Test Job
|
|
|
|
Type = service
|
|
|
|
Priority = 3
|
|
|
|
Datacenters = dc1,dc2,dc3
|
|
|
|
Status = pending
|
|
|
|
```
|
|
|
|
|
|
|
|
Full status information of a job:
|
2015-09-15 03:24:04 +00:00
|
|
|
|
|
|
|
```
|
|
|
|
$ nomad status job1
|
|
|
|
ID = job1
|
|
|
|
Name = Test Job
|
|
|
|
Type = service
|
|
|
|
Priority = 3
|
|
|
|
Datacenters = dc1,dc2,dc3
|
|
|
|
Status = pending
|
2015-09-15 20:09:47 +00:00
|
|
|
|
2015-09-15 23:54:25 +00:00
|
|
|
### Evaluations
|
2015-09-15 20:09:47 +00:00
|
|
|
ID Priority Type TriggeredBy NodeID Status
|
|
|
|
193229c4-aa02-bbe6-f996-fd7d6974a309 3 service job-register node2 complete
|
|
|
|
|
2015-09-15 23:54:25 +00:00
|
|
|
### Allocations
|
2015-09-15 20:09:47 +00:00
|
|
|
ID EvalID NodeID TaskGroup DesiredStatus ClientStatus
|
|
|
|
678c51dc-6c55-0ac8-d92d-675a1e8ea6b0 193229c4-aa02-bbe6-f996-fd7d6974a309 node2 grp8 failed failed
|
2015-09-15 03:24:04 +00:00
|
|
|
```
|