github.com/kardianos/nomad@v0.1.3-0.20151022182107-b13df73ee850/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  The eval-monitor command requires a single argument, specifying the
    24  evaluation ID to monitor. An interactive monitoring session will be
    25  started in the terminal. It is safe to exit the monitor at any time
    26  using ctrl+c.
    27  
    28  The command will exit when the given evaluation reaches a terminal
    29  state (completed or failed). Exit code 0 is returned on successful
    30  evaluation, and if there are no scheduling problems. If there are
    31  job placement issues encountered (unsatisfiable constraints,
    32  resource exhaustion, etc), then the exit code will be 2. Any other
    33  errors, including client connection issues or internal errors, are
    34  indicated by exit code 1.
    35  
    36  ## General Options
    37  
    38  <%= general_options_usage %>
    39  
    40  ## Examples
    41  
    42  Monitor an existing evaluation
    43  
    44  ```
    45  $ nomad eval-monitor 8262bc83-3be0-2894-237c-c06ab5e14785
    46  ==> Monitoring evaluation "8262bc83-3be0-2894-237c-c06ab5e14785"
    47      Allocation "bd6bd0de-1c97-1e6c-ab8b-106618a0393c" created: node "6f299da5-8e4e-0e48-93f4-f544f4b948a8", group "group1"
    48      Evaluation status changed: "pending" -> "complete"
    49  ==> Evaluation "8262bc83-3be0-2894-237c-c06ab5e14785" finished with status "complete"
    50  ```