Files
nomad/website/content/docs/commands/eval/list.mdx
Aimee Ukasick dae496e427 Docs: SEO front matter description for search: commands section (#25175)
* Enhance front matter description for search

* acl section

* alloc section

* config section

* deployment section

* eval section

* job section

* license section

* namespace section

* node section

* node pool section

* operator section

* plugin section

* quota section

* recommendation section

* scaling section

* sentinel section

* server section

* service section

* setup section

* system section

* tls section

* var section

* volume section

* change reference to command reference

* Apply suggestions from code review

Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com>

---------

Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com>
2025-03-19 12:02:02 -05:00

54 lines
1.6 KiB
Plaintext

---
layout: docs
page_title: 'nomad eval list command reference'
description: |
The `nomad eval list` command displays a list of all evaluations or evaluations that match a filter.
---
# `nomad eval list` command reference
The `eval list` command is used list all evaluations.
## Usage
```plaintext
nomad eval list [options]
```
The `eval list` command requires no arguments.
When ACLs are enabled, this command requires a token with the `read-job`
capability for the requested namespace.
## General options
@include 'general_options.mdx'
## List options
- `-verbose`: Show full information.
- `-per-page`: How many results to show per page.
- `-page-token`: Where to start pagination.
- `-filter`: Specifies an expression used to filter query results.
- `-job`: Only show evaluations for this job ID.
- `-status`: Only show evaluations with this status.
- `-json`: Output the evaluation in its JSON format.
- `-t`: Format and display evaluation using a Go template.
- `-ui`: Open the evaluations page in the browser.
## Examples
List all tracked evaluations:
```shell-session
$ nomad eval list -per-page 3 -status complete
ID Priority Triggered By Job ID Namespace Node ID Status Placement Failures
456e37aa 50 deployment-watcher example default <none> complete false
1a1eafe6 50 alloc-stop example default <node> complete false
3411e37b 50 job-register example default <node> complete false
Results have been paginated. To get the next page run:
nomad eval list -page-token 9ecffbba-73be-d909-5d7e-ac2694c10e0c
```