---
layout: "docs"
page_title: "Commands: eval-monitor"
sidebar_current: "docs-commands-eval-monitor"
description: >
  The eval-monitor command is used to attach a log monitor to an existing
  evaluation using its ID.
---

# Command: eval-monitor

The `eval-monitor` command is used to monitor an existing [evaluation](#).
Logs will be output describing state changes to the evaluation or its
associated [allocations](#). The monitor will exit when the evaluation
reaches a terminal state.

## Usage

```
nomad eval-monitor [options] <eval>
```

The eval-monitor command requires a single argument, specifying the
evaluation ID to monitor. An interactive monitoring session will be
started in the terminal. It is safe to exit the monitor at any time
using ctrl+c.

The command will exit when the given evaluation reaches a terminal
state (completed or failed). Exit code 0 is returned on successful
evaluation, and if there are no scheduling problems. If there are
job placement issues encountered (unsatisfiable constraints,
resource exhaustion, etc), then the exit code will be 2. Any other
errors, including client connection issues or internal errors, are
indicated by exit code 1.

## General Options

<%= general_options_usage %>

## Examples

Monitor an existing evaluation

```
$ nomad eval-monitor 8262bc83-3be0-2894-237c-c06ab5e14785
==> Monitoring evaluation "8262bc83-3be0-2894-237c-c06ab5e14785"
    Allocation "bd6bd0de-1c97-1e6c-ab8b-106618a0393c" created: node "6f299da5-8e4e-0e48-93f4-f544f4b948a8", group "group1"
    Evaluation status changed: "pending" -> "complete"
==> Evaluation "8262bc83-3be0-2894-237c-c06ab5e14785" finished with status "complete"
```