github.com/anth0d/nomad@v0.0.0-20221214183521-ae3a0a2cad06/website/content/docs/commands/status.mdx (about)

     1  ---
     2  layout: docs
     3  page_title: 'Commands: status'
     4  description: |
     5    Display the status output for any Nomad resource.
     6  ---
     7  
     8  # Command: status
     9  
    10  The `status` command displays the status output for any Nomad resource.
    11  
    12  ## Usage
    13  
    14  ```plaintext
    15  nomad status [options] <identifier>
    16  ```
    17  
    18  The status command accepts any Nomad identifier or identifier prefix as its sole
    19  argument. The command detects the type of the identifier and routes to the
    20  appropriate status command to display more detailed output.
    21  
    22  If the ID is omitted, the command lists out all of the existing jobs. This is
    23  for backwards compatibility and should not be relied on.
    24  
    25  ## General Options
    26  
    27  @include 'general_options.mdx'
    28  
    29  ## Examples
    30  
    31  Display the status of a job:
    32  
    33  ```shell-session
    34  $ nomad status example
    35  ID            = example
    36  Name          = example
    37  Submit Date   = 08/28/17 23:01:39 UTC
    38  Type          = service
    39  Priority      = 50
    40  Datacenters   = dc1
    41  Status        = running
    42  Periodic      = false
    43  Parameterized = false
    44  
    45  Summary
    46  Task Group  Queued  Starting  Running  Failed  Complete  Lost
    47  cache       0       0         1        0       0         0
    48  
    49  Latest Deployment
    50  ID          = f5506391
    51  Status      = running
    52  Description = Deployment is running
    53  
    54  Deployed
    55  Task Group  Desired  Placed  Healthy  Unhealthy
    56  cache       1        1       0        0
    57  
    58  Allocations
    59  ID        Node ID   Task Group  Version  Desired  Status   Created At
    60  e1d14a39  f9dabe93  cache       0        run      running  08/28/17 23:01:39 UTC
    61  ```
    62  
    63  Display the status of an allocation:
    64  
    65  ```shell-session
    66  $ nomad status e1d14a39
    67  ID                  = e1d14a39
    68  Eval ID             = cc882755
    69  Name                = example.cache[0]
    70  Node ID             = f9dabe93
    71  Job ID              = example
    72  Job Version         = 0
    73  Client Status       = running
    74  Client Description  = <none>
    75  Desired Status      = run
    76  Desired Description = <none>
    77  Created At          = 08/28/17 23:01:39 UTC
    78  Deployment ID       = f5506391
    79  Deployment Health   = healthy
    80  
    81  Task "redis" is "running"
    82  Task Resources
    83  CPU        Memory           Disk     Addresses
    84  4/500 MHz  6.3 MiB/256 MiB  300 MiB  db: 127.0.0.1:21752
    85  
    86  Task Events:
    87  Started At     = 08/28/17 23:01:39 UTC
    88  Finished At    = N/A
    89  Total Restarts = 0
    90  Last Restart   = N/A
    91  
    92  Recent Events:
    93  Time                   Type        Description
    94  08/28/17 23:01:39 UTC  Started     Task started by client
    95  08/28/17 23:01:39 UTC  Task Setup  Building Task Directory
    96  08/28/17 23:01:39 UTC  Received    Task received by client
    97  ```
    98  
    99  Display the status of a deployment:
   100  
   101  ```shell-session
   102  $ nomad status f5506391
   103  ID          = f5506391
   104  Job ID      = example
   105  Job Version = 0
   106  Status      = successful
   107  Description = Deployment completed successfully
   108  
   109  Deployed
   110  Task Group  Desired  Placed  Healthy  Unhealthy
   111  cache       1        1       1        0
   112  ```
   113  
   114  Display the status of a node:
   115  
   116  ```shell-session
   117  $ nomad status f9dabe93
   118  ID      = f9dabe93
   119  Name    = nomad-server01
   120  Class   = <none>
   121  DC      = dc1
   122  Drain   = false
   123  Status  = ready
   124  Drivers = docker,exec,java,qemu,raw_exec,rkt
   125  Uptime  = 4h17m24s
   126  
   127  Allocated Resources
   128  CPU           Memory           Disk
   129  500/8709 MHz  256 MiB/2.0 GiB  300 MiB/24 GiB
   130  
   131  Allocation Resource Utilization
   132  CPU         Memory
   133  3/8709 MHz  6.3 MiB/2.0 GiB
   134  
   135  Host Resource Utilization
   136  CPU           Memory           Disk
   137  116/8709 MHz  335 MiB/2.0 GiB  12 GiB/38 GiB
   138  
   139  Allocations
   140  ID        Node ID   Task Group  Version  Desired  Status   Created At
   141  e1d14a39  f9dabe93  cache       0        run      running  08/28/17 23:01:39 UTC
   142  ```