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