Files
nomad/website/content/commands/status.mdx
Aimee Ukasick 53b083b8c5 Docs: Nomad IA (#26063)
* Move commands from docs to its own root-level directory

* temporarily use modified dev-portal branch with nomad ia changes

* explicitly clone nomad ia exp branch

* retrigger build, fixed dev-portal broken build

* architecture, concepts and get started individual pages

* fix get started section destinations

* reference section

* update repo comment in website-build.sh to show branch

* docs nav file update capitalization

* update capitalization to force deploy

* remove nomad-vs-kubernetes dir; move content to what is nomad pg

* job section

* Nomad operations category, deploy section

* operations category, govern section

* operations - manage

* operations/scale; concepts scheduling fix

* networking

* monitor

* secure section

* remote auth-methods folder and move up pages to sso; linkcheck

* Fix install2deploy redirects

* fix architecture redirects

* Job section: Add missing section index pages

* Add section index pages so breadcrumbs build correctly

* concepts/index fix front matter indentation

* move task driver plugin config to new deploy section

* Finish adding full URL to tutorials links in nav

* change SSO to Authentication in nav and file system

* Docs NomadIA: Move tutorials into NomadIA branch (#26132)

* Move governance and policy from tutorials to docs

* Move tutorials content to job-declare section

* run jobs section

* stateful workloads

* advanced job scheduling

* deploy section

* manage section

* monitor section

* secure/acl and secure/authorization

* fix example that contains an unseal key in real format

* remove images from sso-vault

* secure/traffic

* secure/workload-identities

* vault-acl change unseal key and root token in command output sample

* remove lines from sample output

* fix front matter

* move nomad pack tutorials to tools

* search/replace /nomad/tutorials links

* update acl overview with content from deleted architecture/acl

* fix spelling mistake

* linkcheck - fix broken links

* fix link to Nomad variables tutorial

* fix link to Prometheus tutorial

* move who uses Nomad to use cases page; move spec/config shortcuts

add dividers

* Move Consul out of Integrations; move namespaces to govern

* move integrations/vault to secure/vault; delete integrations

* move ref arch to docs; rename Deploy Nomad back to Install Nomad

* address feedback

* linkcheck fixes

* Fixed raw_exec redirect

* add info from /nomad/tutorials/manage-jobs/jobs

* update page content with newer tutorial

* link updates for architecture sub-folders

* Add redirects for removed section index pages. Fix links.

* fix broken links from linkcheck

* Revert to use dev-portal main branch instead of nomadIA branch

* build workaround: add intro-nav-data.json with single entry

* fix content-check error

* add intro directory to get around Vercel build error

* workound for emtpry directory

* remove mdx from /intro/ to fix content-check and git snafu

* Add intro index.mdx so Vercel build should work

---------

Co-authored-by: Tu Nguyen <im2nguyen@gmail.com>
2025-07-08 19:24:52 -05:00

147 lines
3.5 KiB
Plaintext

---
layout: docs
page_title: 'nomad status command reference'
description: |
The `nomad status` command display the status output for any Nomad resource.
---
# `nomad status` command reference
The `status` command displays the status output for any Nomad resource.
## Usage
```plaintext
nomad status [options] <identifier>
```
The status command accepts any Nomad identifier or identifier prefix as its sole
argument. The command detects the type of the identifier and routes to the
appropriate status command to display more detailed output.
If the ID is omitted, the command lists out all of the existing jobs. This is
for backwards compatibility and should not be relied on.
## Examples
Display the status of a job:
```shell-session
$ nomad status example
ID = example
Name = example
Submit Date = 08/28/17 23:01:39 UTC
Type = service
Priority = 50
Datacenters = dc1
Status = running
Periodic = false
Parameterized = false
Summary
Task Group Queued Starting Running Failed Complete Lost
cache 0 0 1 0 0 0
Latest Deployment
ID = f5506391
Status = running
Description = Deployment is running
Deployed
Task Group Desired Placed Healthy Unhealthy
cache 1 1 0 0
Actions
Action Name Task Group Task
my-action cache my-task
Allocations
ID Node ID Task Group Version Desired Status Created At
e1d14a39 f9dabe93 cache 0 run running 08/28/17 23:01:39 UTC
```
Display the status of an allocation:
```shell-session
$ nomad status e1d14a39
ID = e1d14a39
Eval ID = cc882755
Name = example.cache[0]
Node ID = f9dabe93
Job ID = example
Job Version = 0
Client Status = running
Client Description = <none>
Desired Status = run
Desired Description = <none>
Created At = 08/28/17 23:01:39 UTC
Deployment ID = f5506391
Deployment Health = healthy
Task "redis" is "running"
Task Resources
CPU Memory Disk Addresses
4/500 MHz 6.3 MiB/256 MiB 300 MiB db: 127.0.0.1:21752
Task Events:
Started At = 08/28/17 23:01:39 UTC
Finished At = N/A
Total Restarts = 0
Last Restart = N/A
Recent Events:
Time Type Description
08/28/17 23:01:39 UTC Started Task started by client
08/28/17 23:01:39 UTC Task Setup Building Task Directory
08/28/17 23:01:39 UTC Received Task received by client
```
Display the status of a deployment:
```shell-session
$ nomad status f5506391
ID = f5506391
Job ID = example
Job Version = 0
Status = successful
Description = Deployment completed successfully
Deployed
Task Group Desired Placed Healthy Unhealthy
cache 1 1 1 0
```
Display the status of a node:
```shell-session
$ nomad status f9dabe93
ID = f9dabe93
Name = nomad-server01
Class = <none>
DC = dc1
Drain = false
Status = ready
Drivers = docker,exec,java,qemu,raw_exec,rkt
Uptime = 4h17m24s
Allocated Resources
CPU Memory Disk
500/8709 MHz 256 MiB/2.0 GiB 300 MiB/24 GiB
Allocation Resource Utilization
CPU Memory
3/8709 MHz 6.3 MiB/2.0 GiB
Host Resource Utilization
CPU Memory Disk
116/8709 MHz 335 MiB/2.0 GiB 12 GiB/38 GiB
Allocations
ID Node ID Task Group Version Desired Status Created At
e1d14a39 f9dabe93 cache 0 run running 08/28/17 23:01:39 UTC
```
## General options
@include 'general_options.mdx'