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