2015-09-15 03:24:04 +00:00
|
|
|
---
|
|
|
|
layout: "docs"
|
|
|
|
page_title: "Commands: status"
|
|
|
|
sidebar_current: "docs-commands-status"
|
|
|
|
description: >
|
2017-08-28 23:05:58 +00:00
|
|
|
Display the status output for any Nomad resource.
|
2015-09-15 03:24:04 +00:00
|
|
|
---
|
|
|
|
|
|
|
|
# Command: status
|
|
|
|
|
2018-03-11 18:51:03 +00:00
|
|
|
The `status` command displays the status output for any Nomad resource.
|
2015-09-15 03:24:04 +00:00
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
```
|
2017-08-28 23:05:58 +00:00
|
|
|
nomad status [options] <identifier>
|
2015-09-15 03:24:04 +00:00
|
|
|
```
|
|
|
|
|
2017-08-28 23:05:58 +00:00
|
|
|
The status command accepts any Nomad identifier or identifier prefix as its sole
|
|
|
|
argument. The command detects the type of the identifier and routes to the
|
|
|
|
appropriate status command to display more detailed output.
|
2016-01-06 21:46:57 +00:00
|
|
|
|
2017-08-28 23:05:58 +00:00
|
|
|
If the ID is omitted, the command lists out all of the existing jobs. This is
|
|
|
|
for backwards compatibility and should not be relied on.
|
2015-09-15 03:24:04 +00:00
|
|
|
|
|
|
|
## General Options
|
|
|
|
|
2016-10-28 00:46:20 +00:00
|
|
|
<%= partial "docs/commands/_general_options" %>
|
2015-09-15 03:24:04 +00:00
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
2017-08-28 23:05:58 +00:00
|
|
|
Display the status of a job:
|
2015-09-15 03:24:04 +00:00
|
|
|
|
|
|
|
```
|
2017-07-25 16:15:31 +00:00
|
|
|
$ nomad status example
|
2017-01-26 06:21:51 +00:00
|
|
|
ID = example
|
|
|
|
Name = example
|
2017-08-28 23:05:58 +00:00
|
|
|
Submit Date = 08/28/17 23:01:39 UTC
|
2017-01-26 06:21:51 +00:00
|
|
|
Type = service
|
|
|
|
Priority = 50
|
|
|
|
Datacenters = dc1
|
|
|
|
Status = running
|
|
|
|
Periodic = false
|
|
|
|
Parameterized = false
|
2016-06-16 21:00:45 +00:00
|
|
|
|
2016-08-08 00:38:29 +00:00
|
|
|
Summary
|
|
|
|
Task Group Queued Starting Running Failed Complete Lost
|
|
|
|
cache 0 0 1 0 0 0
|
|
|
|
|
2017-07-25 16:01:45 +00:00
|
|
|
Latest Deployment
|
2017-08-28 23:05:58 +00:00
|
|
|
ID = f5506391
|
|
|
|
Status = running
|
|
|
|
Description = Deployment is running
|
2017-07-25 16:01:45 +00:00
|
|
|
|
|
|
|
Deployed
|
|
|
|
Task Group Desired Placed Healthy Unhealthy
|
2017-08-28 23:05:58 +00:00
|
|
|
cache 1 1 0 0
|
2017-07-25 16:01:45 +00:00
|
|
|
|
2016-06-16 21:00:45 +00:00
|
|
|
Allocations
|
2017-07-25 16:01:45 +00:00
|
|
|
ID Node ID Task Group Version Desired Status Created At
|
2017-08-28 23:05:58 +00:00
|
|
|
e1d14a39 f9dabe93 cache 0 run running 08/28/17 23:01:39 UTC
|
2016-06-16 21:00:45 +00:00
|
|
|
```
|
2015-09-15 20:09:47 +00:00
|
|
|
|
2017-08-28 23:05:58 +00:00
|
|
|
Display the status of an allocation:
|
2017-01-26 06:21:51 +00:00
|
|
|
|
|
|
|
```
|
2017-08-28 23:05:58 +00:00
|
|
|
$ nomad status e1d14a39
|
|
|
|
ID = e1d14a39
|
|
|
|
Eval ID = cc882755
|
|
|
|
Name = example.cache[0]
|
|
|
|
Node ID = f9dabe93
|
|
|
|
Job ID = example
|
|
|
|
Job Version = 0
|
|
|
|
Client Status = running
|
|
|
|
Client Description = <none>
|
|
|
|
Desired Status = run
|
|
|
|
Desired Description = <none>
|
|
|
|
Created At = 08/28/17 23:01:39 UTC
|
|
|
|
Deployment ID = f5506391
|
|
|
|
Deployment Health = healthy
|
2017-01-26 06:21:51 +00:00
|
|
|
|
2017-08-28 23:05:58 +00:00
|
|
|
Task "redis" is "running"
|
|
|
|
Task Resources
|
2018-12-06 23:09:26 +00:00
|
|
|
CPU Memory Disk Addresses
|
|
|
|
4/500 MHz 6.3 MiB/256 MiB 300 MiB db: 127.0.0.1:21752
|
2017-01-26 06:21:51 +00:00
|
|
|
|
2017-08-28 23:05:58 +00:00
|
|
|
Task Events:
|
|
|
|
Started At = 08/28/17 23:01:39 UTC
|
|
|
|
Finished At = N/A
|
|
|
|
Total Restarts = 0
|
|
|
|
Last Restart = N/A
|
2017-01-26 06:21:51 +00:00
|
|
|
|
2017-08-28 23:05:58 +00:00
|
|
|
Recent Events:
|
|
|
|
Time Type Description
|
|
|
|
08/28/17 23:01:39 UTC Started Task started by client
|
|
|
|
08/28/17 23:01:39 UTC Task Setup Building Task Directory
|
|
|
|
08/28/17 23:01:39 UTC Received Task received by client
|
2017-01-26 06:21:51 +00:00
|
|
|
```
|
|
|
|
|
2017-08-28 23:05:58 +00:00
|
|
|
Display the status of a deployment:
|
2015-09-15 20:09:47 +00:00
|
|
|
|
2016-06-16 21:00:45 +00:00
|
|
|
```
|
2017-08-28 23:05:58 +00:00
|
|
|
$ nomad status f5506391
|
|
|
|
ID = f5506391
|
|
|
|
Job ID = example
|
|
|
|
Job Version = 0
|
|
|
|
Status = successful
|
|
|
|
Description = Deployment completed successfully
|
2017-07-25 16:01:45 +00:00
|
|
|
|
|
|
|
Deployed
|
|
|
|
Task Group Desired Placed Healthy Unhealthy
|
2017-08-28 23:05:58 +00:00
|
|
|
cache 1 1 1 0
|
2016-06-16 21:00:45 +00:00
|
|
|
```
|
|
|
|
|
2017-08-28 23:05:58 +00:00
|
|
|
Display the status of a node:
|
2016-06-16 21:00:45 +00:00
|
|
|
|
|
|
|
```
|
2017-08-28 23:05:58 +00:00
|
|
|
$ nomad status f9dabe93
|
|
|
|
ID = f9dabe93
|
|
|
|
Name = nomad-server01
|
|
|
|
Class = <none>
|
|
|
|
DC = dc1
|
|
|
|
Drain = false
|
|
|
|
Status = ready
|
|
|
|
Drivers = docker,exec,java,qemu,raw_exec,rkt
|
|
|
|
Uptime = 4h17m24s
|
2016-06-16 21:00:45 +00:00
|
|
|
|
2017-08-28 23:05:58 +00:00
|
|
|
Allocated Resources
|
2018-12-06 23:09:26 +00:00
|
|
|
CPU Memory Disk
|
|
|
|
500/8709 MHz 256 MiB/2.0 GiB 300 MiB/24 GiB
|
2016-06-16 21:00:45 +00:00
|
|
|
|
2017-08-28 23:05:58 +00:00
|
|
|
Allocation Resource Utilization
|
|
|
|
CPU Memory
|
|
|
|
3/8709 MHz 6.3 MiB/2.0 GiB
|
2017-07-25 16:01:45 +00:00
|
|
|
|
2017-08-28 23:05:58 +00:00
|
|
|
Host Resource Utilization
|
|
|
|
CPU Memory Disk
|
|
|
|
116/8709 MHz 335 MiB/2.0 GiB 12 GiB/38 GiB
|
2017-07-25 16:01:45 +00:00
|
|
|
|
2016-06-16 21:00:45 +00:00
|
|
|
Allocations
|
2017-07-25 16:01:45 +00:00
|
|
|
ID Node ID Task Group Version Desired Status Created At
|
2017-08-28 23:05:58 +00:00
|
|
|
e1d14a39 f9dabe93 cache 0 run running 08/28/17 23:01:39 UTC
|
2015-09-15 03:24:04 +00:00
|
|
|
```
|