github.com/smintz/nomad@v0.8.3/website/source/docs/commands/eval-status.html.md.erb (about)

     1  ---
     2  layout: "docs"
     3  page_title: "Commands: eval status"
     4  sidebar_current: "docs-commands-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  ```
    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  <%= partial "docs/commands/_general_options" %>
    44  
    45  ## Eval Status Options
    46  
    47  * `-monitor`: Monitor an outstanding evaluation
    48  
    49  * `-verbose`: Show full information.
    50  
    51  * `-json` : Output the evaluation in its JSON format.
    52  
    53  * `-t` : Format and display evaluation using a Go template.
    54  
    55  ## Examples
    56  
    57  Show the status of an evaluation that has placement failures
    58  
    59  ```
    60  $ nomad eval status 2ae0e6a5
    61  ID                 = 2ae0e6a5
    62  Status             = complete
    63  Status Description = complete
    64  Type               = service
    65  TriggeredBy        = job-register
    66  Job ID             = example
    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  ```
    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  ```