138 lines
4.1 KiB
Plaintext
138 lines
4.1 KiB
Plaintext
---
|
|
layout: "docs"
|
|
page_title: "Commands: alloc-status"
|
|
sidebar_current: "docs-commands-alloc-status"
|
|
description: >
|
|
Display status and metadata about existing allocations and their tasks.
|
|
---
|
|
|
|
# Command: alloc-status
|
|
|
|
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.
|
|
|
|
## 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.
|
|
|
|
## General Options
|
|
|
|
<%= partial "docs/commands/_general_options" %>
|
|
|
|
## Alloc Status Options
|
|
|
|
* `-short`: Display short output. Shows only the most recent task event.
|
|
* `-verbose`: Show full information.
|
|
* `-json` : Output the allocation in its JSON format.
|
|
* `-t` : Format and display allocation using a Go template.
|
|
|
|
## Examples
|
|
|
|
Short status of an alloc:
|
|
|
|
```
|
|
$ nomad alloc-status --short 13901f26
|
|
ID = 13901f26
|
|
Eval ID = c3c9a1db
|
|
Name = example.cache[0]
|
|
Node ID = 1f029d38
|
|
Job ID = example
|
|
Client Status = running
|
|
Created At = 29/03/16 03:04:53 UTC
|
|
|
|
==> Tasks
|
|
Name State Last Event Time
|
|
redis running Started 29/03/16 03:04:53 UTC
|
|
web running Started 29/03/16 03:04:53 UTC
|
|
```
|
|
|
|
Full status of an alloc, which shows one of the tasks dying and then being restarted:
|
|
|
|
```
|
|
$ nomad alloc-status a7365fe4
|
|
ID = a7365fe4
|
|
Eval ID = c3c9a1db
|
|
Name = example.cache[0]
|
|
Node ID = 1f029d38
|
|
Job ID = example
|
|
Client Status = running
|
|
Created At = 29/03/16 03:04:53 UTC
|
|
|
|
==> Task Resources
|
|
Task: "redis"
|
|
CPU Memory MB Disk MB IOPS Addresses
|
|
500 256 300 0 db: 127.0.0.1:46321
|
|
|
|
Task: "web"
|
|
CPU Memory MB Disk MB IOPS Addresses
|
|
500 256 300 0 db: 127.0.0.1:38537
|
|
|
|
==> Task "redis" is "running"
|
|
Recent Events:
|
|
Time Type Description
|
|
29/03/16 03:04:53 UTC Started Task started by client
|
|
29/03/16 03:04:51 UTC Received Task received by client
|
|
|
|
==> Task "web" is "pending"
|
|
Recent Events:
|
|
Time Type Description
|
|
29/03/16 03:07:18 UTC Restarting Task restarting in 18.580059474s
|
|
29/03/16 03:07:18 UTC Terminated Exit Code: 137, Exit Message: "Docker container exited with non-zero exit code: 137"
|
|
29/03/16 03:04:53 UTC Started Task started by client
|
|
29/03/16 03:04:51 UTC Received Task received by client
|
|
```
|
|
|
|
Verbose status can also be accessed:
|
|
|
|
```
|
|
$ nomad alloc-status --verbose a7365fe4
|
|
ID = a7365fe4-cb28-a6e9-f3d4-f99e49c89776
|
|
Eval ID = c3c9a1db-dbeb-8afa-0a83-4f1b8b5a03f5
|
|
Name = example.cache[0]
|
|
Node ID = 1f029d38-8d4b-a552-261f-e457b60f9b4b
|
|
Job ID = example
|
|
Client Status = running
|
|
Created At = 29/03/16 03:04:53 UTC
|
|
Evaluated Nodes = 1
|
|
Filtered Nodes = 0
|
|
Exhausted Nodes = 0
|
|
Allocation Time = 1.085001ms
|
|
Failures = 0
|
|
|
|
==> Task Resources
|
|
Task: "web"
|
|
CPU Memory MB Disk MB IOPS Addresses
|
|
500 256 300 0 db: 127.0.0.1:38537
|
|
|
|
Task: "redis"
|
|
CPU Memory MB Disk MB IOPS Addresses
|
|
500 256 300 0 db: 127.0.0.1:46321
|
|
|
|
==> Task "redis" is "running"
|
|
Recent Events:
|
|
Time Type Description
|
|
29/03/16 03:04:53 UTC Started Task started by client
|
|
29/03/16 03:04:51 UTC Received Task received by client
|
|
|
|
==> Task "web" is "running"
|
|
Recent Events:
|
|
Time Type Description
|
|
29/03/16 03:07:38 UTC Started Task started by client
|
|
29/03/16 03:07:18 UTC Restarting Task restarting in 18.580059474s
|
|
29/03/16 03:07:18 UTC Terminated Exit Code: 137, Exit Message: "Docker container exited with non-zero exit code: 137"
|
|
29/03/16 03:04:53 UTC Started Task started by client
|
|
29/03/16 03:04:51 UTC Received Task received by client
|
|
|
|
==> Status
|
|
Allocation "13901f26-cb28-a6e9-f3d4-f99e49c89776" status "running" (0/1 nodes filtered)
|
|
* Score "1f029d38-8d4b-a552-261f-e457b60f9b4b.binpack" = 10.334026
|
|
```
|