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

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