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

176 lines
5 KiB
Plaintext
Raw Normal View History

2015-09-27 21:20:09 +00:00
---
layout: "docs"
page_title: "Commands: alloc-status"
sidebar_current: "docs-commands-alloc-status"
description: >
2015-11-17 02:36:13 +00:00
Display status and metadata about existing allocations and their tasks.
2015-09-27 21:20:09 +00:00
---
# Command: alloc-status
2015-11-17 02:36:13 +00:00
The `alloc-status` command displays status information and metadata about an
existing allocation and its tasks. It can be useful while debugging to reveal
the underlying reasons for scheduling decisions or failures, as well as the
current state of its tasks. As of Nomad 0.7.1, alloc status also shows allocation
modification time in addition to create time.
2015-09-27 21:20:09 +00:00
## Usage
```
nomad alloc-status [options] <allocation>
```
An allocation ID or prefix must be provided. If there is an exact match, the
full details of the allocation will be displayed. Otherwise, a list of matching
allocations and information will be displayed.
2015-09-27 21:20:09 +00:00
## General Options
2016-10-28 00:46:20 +00:00
<%= partial "docs/commands/_general_options" %>
2016-01-19 23:01:26 +00:00
2016-08-09 13:56:26 +00:00
## Alloc Status Options
2015-11-17 02:36:13 +00:00
* `-short`: Display short output. Shows only the most recent task event.
2016-01-19 23:01:26 +00:00
* `-verbose`: Show full information.
2016-08-06 09:54:30 +00:00
* `-json` : Output the allocation in its JSON format.
2017-07-25 16:23:44 +00:00
* `-t` : Format and display the allocation using a Go template.
2015-09-27 21:20:09 +00:00
## Examples
2015-11-17 02:36:13 +00:00
Short status of an alloc:
2015-09-27 21:20:09 +00:00
```
2017-07-25 16:15:31 +00:00
$ nomad alloc-status --short 0af996ed
ID = 0af996ed
Eval ID = be9bde98
Name = example.cache[0]
Node ID = 43c0b14e
Job ID = example
Job Version = 0
Client Status = running
Client Description = <none>
Desired Status = run
Desired Description = <none>
Created At = 07/25/17 16:12:48 UTC
Deployment ID = 0c83a3b1
Deployment Health = healthy
Tasks
2016-03-29 19:36:24 +00:00
Name State Last Event Time
2017-07-25 16:15:31 +00:00
redis running Started 07/25/17 16:12:48 UTC
web running Started 07/25/17 16:12:49 UTC
2015-11-17 02:36:13 +00:00
```
Full status of an alloc, which shows one of the tasks dying and then being restarted:
```
2017-07-25 16:15:31 +00:00
$ nomad alloc-status 0af996ed
ID = 0af996ed
Eval ID = be9bde98
Name = example.cache[0]
2017-07-25 16:15:31 +00:00
Node ID = 43c0b14e
Job ID = example
2017-07-25 16:15:31 +00:00
Job Version = 0
Client Status = running
Client Description = <none>
Desired Status = run
Desired Description = <none>
Created = 5m ago
Modified = 5m ago
2017-07-25 16:15:31 +00:00
Deployment ID = 0c83a3b1
Deployment Health = healthy
Task "redis" is "running"
Task Resources
CPU Memory Disk IOPS Addresses
2017-07-25 16:15:31 +00:00
1/500 MHz 6.3 MiB/256 MiB 300 MiB 0 db: 127.0.0.1:27908
Task Events:
2017-07-25 16:15:31 +00:00
Started At = 07/25/17 16:12:48 UTC
Finished At = N/A
Total Restarts = 0
Last Restart = N/A
2016-03-29 19:36:24 +00:00
Recent Events:
Time Type Description
2017-07-25 16:15:31 +00:00
07/25/17 16:12:48 UTC Started Task started by client
07/25/17 16:12:48 UTC Task Setup Building Task Directory
07/25/17 16:12:48 UTC Received Task received by client
2016-03-29 19:36:24 +00:00
Task "web" is "running"
Task Resources
CPU Memory Disk IOPS Addresses
2017-07-25 16:15:31 +00:00
1/500 MHz 6.3 MiB/256 MiB 300 MiB 0 db: 127.0.0.1:30572
2015-11-17 02:36:13 +00:00
Task Events:
2017-07-25 16:15:31 +00:00
Started At = 07/25/17 16:12:49 UTC
>>>>>>> alloc-status
Finished At = N/A
Total Restarts = 0
Last Restart = N/A
2015-11-17 02:36:13 +00:00
Recent Events:
2017-07-25 16:15:31 +00:00
07/25/17 16:12:49 UTC Started Task started by client
07/25/17 16:12:48 UTC Task Setup Building Task Directory
07/25/17 16:12:48 UTC Received Task received by client
2016-03-29 19:36:24 +00:00
```
2015-11-17 02:36:13 +00:00
2016-03-29 19:36:24 +00:00
Verbose status can also be accessed:
```
2017-07-25 16:15:31 +00:00
$ nomad alloc-status -verbose 0af996ed
ID = 0af996ed-aff4-8ddb-a566-e55ebf8969c9
Eval ID = be9bde98-0490-1beb-ced0-012d10ddf22e
Name = example.cache[0]
2017-07-25 16:15:31 +00:00
Node ID = 43c0b14e-7f96-e432-a7da-06605257ce0c
Job ID = example
2017-07-25 16:15:31 +00:00
Job Version = 0
Client Status = running
Client Description = <none>
Desired Status = run
Desired Description = <none>
Created = 07/25/17 16:12:48 UTC
Modified = 07/25/17 16:12:48 UTC
2017-07-25 16:15:31 +00:00
Deployment ID = 0c83a3b1-8a7b-136b-0e11-8383dc6c9276
Deployment Health = healthy
Evaluated Nodes = 1
Filtered Nodes = 0
Exhausted Nodes = 0
2017-07-25 16:15:31 +00:00
Allocation Time = 38.474µs
Failures = 0
Task "redis" is "running"
Task Resources
CPU Memory Disk IOPS Addresses
2017-07-25 16:15:31 +00:00
1/500 MHz 6.3 MiB/256 MiB 300 MiB 0 db: 127.0.0.1:27908
Task Events:
2017-07-25 16:15:31 +00:00
Started At = 07/25/17 16:12:48 UTC
Finished At = N/A
Total Restarts = 0
Last Restart = N/A
2016-03-29 19:36:24 +00:00
Recent Events:
Time Type Description
2017-07-25 16:15:31 +00:00
07/25/17 16:12:48 UTC Started Task started by client
07/25/17 16:12:48 UTC Task Setup Building Task Directory
07/25/17 16:12:48 UTC Received Task received by client
Task "web" is "running"
Task Resources
CPU Memory Disk IOPS Addresses
2017-07-25 16:15:31 +00:00
1/500 MHz 6.3 MiB/256 MiB 300 MiB 0 db: 127.0.0.1:30572
Task Events:
2017-07-25 16:15:31 +00:00
Started At = 07/25/17 16:12:49 UTC
Finished At = N/A
Total Restarts = 0
Last Restart = N/A
2016-03-29 19:36:24 +00:00
Recent Events:
Time Type Description
2017-07-25 16:15:31 +00:00
07/25/17 16:12:49 UTC Started Task started by client
07/25/17 16:12:48 UTC Task Setup Building Task Directory
07/25/17 16:12:48 UTC Received Task received by client
2015-09-27 21:20:09 +00:00
```