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 ```