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

144 lines
3.4 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 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
```
nomad status [options] <identifier>
2015-09-15 03:24:04 +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.
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
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
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
ID = f5506391
Status = running
Description = Deployment is running
2017-07-25 16:01:45 +00:00
Deployed
Task Group Desired Placed Healthy Unhealthy
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
e1d14a39 f9dabe93 cache 0 run running 08/28/17 23:01:39 UTC
2016-06-16 21:00:45 +00:00
```
Display the status of an allocation:
2017-01-26 06:21:51 +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
Task "redis" is "running"
Task Resources
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
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
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
```
Display the status of a deployment:
2016-06-16 21:00:45 +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
cache 1 1 1 0
2016-06-16 21:00:45 +00:00
```
Display the status of a node:
2016-06-16 21:00:45 +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
Allocated Resources
CPU Memory Disk
500/8709 MHz 256 MiB/2.0 GiB 300 MiB/24 GiB
2016-06-16 21:00:45 +00:00
Allocation Resource Utilization
CPU Memory
3/8709 MHz 6.3 MiB/2.0 GiB
2017-07-25 16:01:45 +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
e1d14a39 f9dabe93 cache 0 run running 08/28/17 23:01:39 UTC
2015-09-15 03:24:04 +00:00
```