github.com/adityamillind98/nomad@v0.11.8/website/pages/docs/commands/eval-status.mdx (about)

     1  ---
     2  layout: docs
     3  page_title: 'Commands: eval status'
     4  sidebar_title: eval status
     5  description: >
     6    The eval status command is used to see the status and potential failed
     7    allocations of an evaluation.
     8  ---
     9  
    10  # Command: eval status
    11  
    12  The `eval status` command is used to display information about an existing
    13  evaluation. In the case an evaluation could not place all the requested
    14  allocations, this command can be used to determine the failure reasons.
    15  
    16  Optionally, it can also be invoked in a monitor mode to track an outstanding
    17  evaluation. In this mode, logs will be output describing state changes to the
    18  evaluation or its associated allocations. The monitor will exit when the
    19  evaluation reaches a terminal state.
    20  
    21  ## Usage
    22  
    23  ```plaintext
    24  nomad eval status [options] <evaluation>
    25  ```
    26  
    27  An evaluation ID or prefix must be provided. If there is an exact match, the
    28  the status will be shown. Otherwise, a list of matching evaluations and
    29  information will be displayed.
    30  
    31  If the `-monitor` flag is passed, an interactive monitoring session will be
    32  started in the terminal. It is safe to exit the monitor at any time using
    33  ctrl+c. The command will exit when the given evaluation reaches a terminal
    34  state (completed or failed). Exit code 0 is returned on successful
    35  evaluation, and if there are no scheduling problems. If there are
    36  job placement issues encountered (unsatisfiable constraints,
    37  resource exhaustion, etc), then the exit code will be 2. Any other
    38  errors, including client connection issues or internal errors, are
    39  indicated by exit code 1.
    40  
    41  ## General Options
    42  
    43  @include 'general_options.mdx'
    44  
    45  ## Eval Status Options
    46  
    47  - `-monitor`: Monitor an outstanding evaluation
    48  - `-verbose`: Show full information.
    49  - `-json` : Output the evaluation in its JSON format.
    50  - `-t` : Format and display evaluation using a Go template.
    51  
    52  ## Examples
    53  
    54  Show the status of an evaluation that has placement failures
    55  
    56  ```shell-session
    57  $ nomad eval status 2ae0e6a5
    58  ID                 = 2ae0e6a5
    59  Status             = complete
    60  Status Description = complete
    61  Type               = service
    62  TriggeredBy        = job-register
    63  Job ID             = example
    64  Priority           = 50
    65  Placement Failures = true
    66  
    67  ==> Failed Placements
    68  Task Group "cache" (failed to place 1 allocation):
    69    * Class "foo" filtered 1 nodes
    70    * Constraint "${attr.kernel.name} = windows" filtered 1 nodes
    71  
    72  
    73  Evaluation "67493a64" waiting for additional capacity to place remainder
    74  ```
    75  
    76  Monitor an existing evaluation
    77  
    78  ```shell-session
    79  $ nomad eval status -monitor 8262bc83
    80  ==> Monitoring evaluation "8262bc83"
    81      Allocation "bd6bd0de" created: node "6f299da5", group "group1"
    82      Evaluation status changed: "pending" -> "complete"
    83  ==> Evaluation "8262bc83" finished with status "complete"
    84  ```