github.com/dkerwin/nomad@v0.3.3-0.20160525181927-74554135514b/website/source/docs/commands/eval-monitor.html.md.erb (about)

     1  ---
     2  layout: "docs"
     3  page_title: "Commands: eval-monitor"
     4  sidebar_current: "docs-commands-eval-monitor"
     5  description: >
     6    The eval-monitor command is used to attach a log monitor to an existing
     7    evaluation using its ID.
     8  ---
     9  
    10  # Command: eval-monitor
    11  
    12  The `eval-monitor` command is used to monitor an existing [evaluation](#).
    13  Logs will be output describing state changes to the evaluation or its
    14  associated [allocations](#). The monitor will exit when the evaluation
    15  reaches a terminal state.
    16  
    17  ## Usage
    18  
    19  ```
    20  nomad eval-monitor [options] <eval>
    21  ```
    22  
    23  An evaluation ID or prefix must be provided. If there is an exact match, the
    24  the evaluation will be monitored. Otherwise, a list of matching evaluations and
    25  information will be displayed.
    26  
    27  An interactive monitoring session will be started in the terminal. It is safe
    28  to exit the monitor at any time using ctrl+c.
    29  
    30  The command will exit when the given evaluation reaches a terminal
    31  state (completed or failed). Exit code 0 is returned on successful
    32  evaluation, and if there are no scheduling problems. If there are
    33  job placement issues encountered (unsatisfiable constraints,
    34  resource exhaustion, etc), then the exit code will be 2. Any other
    35  errors, including client connection issues or internal errors, are
    36  indicated by exit code 1.
    37  
    38  ## General Options
    39  
    40  <%= general_options_usage %>
    41  
    42  ## Status Options
    43  
    44  * `-verbose`: Show full information.
    45  
    46  ## Examples
    47  
    48  Monitor an existing evaluation
    49  
    50  ```
    51  $ nomad eval-monitor 8262bc83
    52  ==> Monitoring evaluation "8262bc83"
    53      Allocation "bd6bd0de" created: node "6f299da5", group "group1"
    54      Evaluation status changed: "pending" -> "complete"
    55  ==> Evaluation "8262bc83" finished with status "complete"
    56  ```