github.com/mattyr/nomad@v0.3.3-0.20160919021406-3485a065154a/website/source/docs/commands/status.html.md.erb (about)

     1  ---
     2  layout: "docs"
     3  page_title: "Commands: status"
     4  sidebar_current: "docs-commands-status"
     5  description: >
     6    Display information and status of jobs.
     7  ---
     8  
     9  # Command: status
    10  
    11  The `status` command displays status information for jobs.
    12  
    13  ## Usage
    14  
    15  ```
    16  nomad status [options] [job]
    17  ```
    18  
    19  This command accepts an optional job ID or prefix as the sole argument. If there
    20  is an exact match based on the provided job ID or prefix, then information about
    21  the specific job is queried and displayed. Otherwise, a list of matching jobs and
    22  information will be displayed.
    23  
    24  If the ID is omitted, the command lists out all of the existing jobs and a few of
    25  the most useful status fields for each.
    26  
    27  ## General Options
    28  
    29  <%= general_options_usage %>
    30  
    31  ## Status Options
    32  
    33  * `-evals`: Display the evaluations associated with the job.
    34  
    35  * `-short`: Display short output. Used only when a single node is being queried.
    36    Drops verbose node allocation data from the output.
    37  
    38  * `-verbose`: Show full information.
    39  
    40  ## Examples
    41  
    42  List of all jobs:
    43  
    44  ```
    45  $ nomad status
    46  ID     Type     Priority  Status
    47  job1   service  3         pending
    48  job2   service  3         running
    49  job3   service  2         pending
    50  job4   service  1         complete
    51  ```
    52  
    53  Short view of a specific job:
    54  
    55  ```
    56  $ nomad status -short job1
    57  ID          = job1
    58  Name        = Test Job
    59  Type        = service
    60  Priority    = 3
    61  Datacenters = dc1,dc2,dc3
    62  Status      = pending
    63  Periodic    = false
    64  ```
    65  
    66  Full status information of a job:
    67  
    68  ```
    69  $ nomad status example
    70  ID          = example
    71  Name        = example
    72  Type        = service
    73  Priority    = 50
    74  Datacenters = dc1
    75  Status      = running
    76  Periodic    = false
    77  
    78  Summary
    79  Task Group  Queued  Starting  Running  Failed  Complete  Lost
    80  cache       0       0         1        0       0         0
    81  
    82  Allocations
    83  ID        Eval ID   Node ID   Task Group  Desired  Status   Created At
    84  24cfd201  81efc2fa  8d0331e9  cache       run      running  08/08/16 21:03:19 CDT
    85  ```
    86  
    87  Full status information of a job with placement failures:
    88  
    89  ```
    90  $ nomad status example
    91  ID          = example
    92  Name        = example
    93  Type        = service
    94  Priority    = 50
    95  Datacenters = dc1
    96  Status      = running
    97  Periodic    = false
    98  
    99  Summary
   100  Task Group  Queued  Starting  Running  Failed  Complete  Lost
   101  cache       0       0         5        0       0         0
   102  
   103  Placement Failure
   104  Task Group "cache":
   105    * Resources exhausted on 1 nodes
   106    * Dimension "cpu exhausted" exhausted on 1 nodes
   107  
   108  Allocations
   109  ID        Eval ID   Node ID   Task Group  Desired  Status   Created At
   110  0b8b9e37  8bf94335  8d0331e9  cache       run      running  08/08/16 21:03:19 CDT
   111  b206088c  8bf94335  8d0331e9  cache       run      running  08/08/16 21:03:18 CDT
   112  b82f58b6  8bf94335  8d0331e9  cache       run      running  08/08/16 21:03:17 CDT
   113  ed3665f5  8bf94335  8d0331e9  cache       run      running  08/08/16 21:03:21 CDT
   114  24cfd201  8bf94335  8d0331e9  cache       run      running  08/08/16 21:03:19 CDT
   115  ```
   116  
   117  Full status information showing evaluations with a placement failure. The in
   118  progress evaluation denotes that Nomad is blocked waiting for resources to
   119  become availables so that it can place the remaining allocations.
   120  
   121  ```
   122  $ nomad status -evals example
   123  ID          = example
   124  Name        = example
   125  Type        = service
   126  Priority    = 50
   127  Datacenters = dc1
   128  Status      = running
   129  Periodic    = false
   130  
   131  Summary
   132  Task Group  Queued  Starting  Running  Failed  Complete  Lost
   133  cache       0       0         5        0       0         0
   134  
   135  Evaluations
   136  ID        Priority  Triggered By  Status    Placement Failures
   137  69f34a37  50        job-register  blocked   N/A - In Progress
   138  8bf94335  50        job-register  complete  true
   139  df79bec7  50        job-register  complete  false
   140  81efc2fa  50        job-register  complete  false
   141  
   142  Placement Failure
   143  Task Group "cache":
   144    * Resources exhausted on 1 nodes
   145    * Dimension "cpu exhausted" exhausted on 1 nodes
   146  
   147  Allocations
   148  ID        Eval ID   Node ID   Task Group  Desired  Status   Created At
   149  0b8b9e37  8bf94335  8d0331e9  cache       run      running  08/08/16 21:03:19 CDT
   150  b206088c  8bf94335  8d0331e9  cache       run      running  08/08/16 21:03:19 CDT
   151  b82f58b6  8bf94335  8d0331e9  cache       run      running  08/08/16 21:03:19 CDT
   152  ed3665f5  8bf94335  8d0331e9  cache       run      running  08/08/16 21:03:19 CDT
   153  24cfd201  8bf94335  8d0331e9  cache       run      running  08/08/16 21:03:19 CDT
   154  ```