github.com/iqoqo/nomad@v0.11.3-0.20200911112621-d7021c74d101/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-sessionnomad eval status 2ae0e6a5
    57  ID                 = 2ae0e6a5
    58  Status             = complete
    59  Status Description = complete
    60  Type               = service
    61  TriggeredBy        = job-register
    62  Job ID             = example
    63  Priority           = 50
    64  Placement Failures = true
    65  
    66  ==> Failed Placements
    67  Task Group "cache" (failed to place 1 allocation):
    68    * Class "foo" filtered 1 nodes
    69    * Constraint "${attr.kernel.name} = windows" filtered 1 nodes
    70  
    71  
    72  Evaluation "67493a64" waiting for additional capacity to place remainder
    73  ```
    74  
    75  Monitor an existing evaluation
    76  
    77  ```shell-sessionnomad eval status -monitor 8262bc83
    78  ==> Monitoring evaluation "8262bc83"
    79      Allocation "bd6bd0de" created: node "6f299da5", group "group1"
    80      Evaluation status changed: "pending" -> "complete"
    81  ==> Evaluation "8262bc83" finished with status "complete"
    82  ```