81 lines
1.8 KiB
Plaintext
81 lines
1.8 KiB
Plaintext
---
|
|
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]
|
|
```
|
|
|
|
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.
|
|
|
|
## General Options
|
|
|
|
<%= general_options_usage %>
|
|
|
|
## Status Options
|
|
|
|
* `-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.
|
|
|
|
## Examples
|
|
|
|
List of all jobs:
|
|
|
|
```
|
|
$ 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:
|
|
|
|
```
|
|
$ 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 3 service job-register node2 complete
|
|
|
|
### Allocations
|
|
ID EvalID NodeID TaskGroup DesiredStatus ClientStatus
|
|
678c51dc 193229c4 node2 grp8 failed failed
|
|
```
|