open-nomad/website/source/docs/commands/status.html.md.erb

77 lines
1.8 KiB
Plaintext
Raw Normal View History

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
<%= general_options_usage %>
2015-09-15 03:24:04 +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
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
```
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
### Evaluations
ID Priority Type TriggeredBy NodeID Status
193229c4-aa02-bbe6-f996-fd7d6974a309 3 service job-register node2 complete
### Allocations
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
```