--- layout: "docs" page_title: "Commands: status" sidebar_current: "docs-commands-status" description: > Display information and status of jobs. --- # Command: status The `status` command displays status information for jobs. ## Usage ``` nomad status [options] [job] ``` This command accepts an optional job ID or prefix as the sole argument. If there is an exact match based on the provided job ID or prefix, then information about the specific job is queried and displayed. Otherwise, a list of matching jobs and information will be displayed. If the ID is omitted, the command lists out all of the existing jobs and a few of the most useful status fields for each. ## General Options <%= partial "docs/commands/_general_options" %> ## Status Options * `-evals`: Display the evaluations associated with the job. * `-short`: Display short output. Used only when a single node is being queried. Drops verbose node allocation data from the output. * `-verbose`: Show full information. ## Examples List of all jobs: ``` $ nomad status ID Type Priority Status job1 service 3 pending job2 service 3 running job3 service 2 pending job4 service 1 complete ``` Short view of a specific job: ``` $ nomad status -short job1 ID = job1 Name = Test Job Type = service Priority = 3 Datacenters = dc1,dc2,dc3 Status = pending Periodic = false Parameterized = false ``` Full status information of a job: ``` $ nomad status example ID = example Name = example Type = service Priority = 50 Datacenters = dc1 Status = running Periodic = false Parameterized = false Summary Task Group Queued Starting Running Failed Complete Lost cache 0 0 1 0 0 0 Allocations ID Eval ID Node ID Task Group Desired Status Created At 24cfd201 81efc2fa 8d0331e9 cache run running 08/08/16 21:03:19 CDT ``` Full status information of a perodic job: ``` ID = example Name = example Type = batch Priority = 50 Datacenters = dc1 Status = running Periodic = true Parameterized = false Next Periodic Launch = 01/26/17 06:19:46 UTC (1s from now) Children Job Summary Pending Running Dead 0 5 0 Previously Launched Jobs ID Status example/periodic-1485411581 running example/periodic-1485411582 running example/periodic-1485411583 running example/periodic-1485411584 running example/periodic-1485411585 running ``` Full status information of a parameterized job: ``` ID = example Name = example Type = batch Priority = 50 Datacenters = dc1 Status = running Periodic = false Parameterized = true Parameterized Job Payload = required Required Metadata = foo Optional Metadata = bar Parameterized Job Summary Pending Running Dead 0 2 0 Dispatched Jobs ID Status example/dispatch-1485411496-58f24d2d running example/dispatch-1485411499-fa2ee40e running ``` Full status information of a job with placement failures: ``` $ nomad status example ID = example Name = example Type = service Priority = 50 Datacenters = dc1 Status = running Periodic = false Parameterized = false Summary Task Group Queued Starting Running Failed Complete Lost cache 0 0 5 0 0 0 Placement Failure Task Group "cache": * Resources exhausted on 1 nodes * Dimension "cpu exhausted" exhausted on 1 nodes Allocations ID Eval ID Node ID Task Group Desired Status Created At 0b8b9e37 8bf94335 8d0331e9 cache run running 08/08/16 21:03:19 CDT b206088c 8bf94335 8d0331e9 cache run running 08/08/16 21:03:18 CDT b82f58b6 8bf94335 8d0331e9 cache run running 08/08/16 21:03:17 CDT ed3665f5 8bf94335 8d0331e9 cache run running 08/08/16 21:03:21 CDT 24cfd201 8bf94335 8d0331e9 cache run running 08/08/16 21:03:19 CDT ``` Full status information showing evaluations with a placement failure. The in progress evaluation denotes that Nomad is blocked waiting for resources to become availables so that it can place the remaining allocations. ``` $ nomad status -evals example ID = example Name = example Type = service Priority = 50 Datacenters = dc1 Status = running Periodic = false Parameterized = false Summary Task Group Queued Starting Running Failed Complete Lost cache 0 0 5 0 0 0 Evaluations ID Priority Triggered By Status Placement Failures 69f34a37 50 job-register blocked N/A - In Progress 8bf94335 50 job-register complete true df79bec7 50 job-register complete false 81efc2fa 50 job-register complete false Placement Failure Task Group "cache": * Resources exhausted on 1 nodes * Dimension "cpu exhausted" exhausted on 1 nodes Allocations ID Eval ID Node ID Task Group Desired Status Created At 0b8b9e37 8bf94335 8d0331e9 cache run running 08/08/16 21:03:19 CDT b206088c 8bf94335 8d0331e9 cache run running 08/08/16 21:03:19 CDT b82f58b6 8bf94335 8d0331e9 cache run running 08/08/16 21:03:19 CDT ed3665f5 8bf94335 8d0331e9 cache run running 08/08/16 21:03:19 CDT 24cfd201 8bf94335 8d0331e9 cache run running 08/08/16 21:03:19 CDT ```