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