---
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
```
