open-nomad/website/source/docs/commands/alloc-status.html.md.erb
2015-09-27 17:52:55 -07:00

49 lines
1.2 KiB
Plaintext

---
layout: "docs"
page_title: "Commands: alloc-status"
sidebar_current: "docs-commands-alloc-status"
description: >
Display status and metadata about existing allocations
---
# Command: alloc-status
The `alloc-status` command displays status information and metadata about
an existing allocation. It can be useful while debugging to reveal the
underlying reasons for scheduling decisions or failures.
## Usage
```
nomad alloc-status [options] <allocation>
```
An allocation ID must be provided. This specific allocation will be queried
and detailed information for it will be dumped.
## General Options
<%= general_options_usage %>
## Examples
```
nomad alloc-status 9f3276d6-c873-c0a3-81ae-247e8c665cbe
ID = 9f3276d6-c873-c0a3-81ae-247e8c665cbe
EvalID = dc186cc2-a9b2-218e-cc00-eea3d4eaccf4
Name = example.cache[0]
NodeID = <none>
JobID = example
ClientStatus = failed
ClientDescription = <none>
NodesEvaluated = 1
NodesFiltered = 1
NodesExhausted = 0
AllocationTime = 15.242µs
CoalescedFailures = 0
==> Status
Allocation "9f3276d6-c873-c0a3-81ae-247e8c665cbe" status "failed" (1/1 nodes filtered)
* Constraint "$attr.kernel.name = linux" filtered 1 nodes
```