HashiDays One conference. Three cities. Find a city near you
Nomad
Nomad Home

You are viewing documentation for version v1.5.x. View latest version.

Command: status

The status command displays the status output for any Nomad resource.

Usage

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.

General Options

  • -address=<addr>: The address of the Nomad server. Overrides the NOMAD_ADDR environment variable if set. Defaults to http://127.0.0.1:4646.

  • -region=<region>: The region of the Nomad server to forward commands to. Overrides the NOMAD_REGION environment variable if set. Defaults to the Agent's local region.

  • -namespace=<namespace>: The target namespace for queries and actions bound to a namespace. Overrides the NOMAD_NAMESPACE environment variable if set. If set to '*', job and alloc subcommands query all namespaces authorized to user. Defaults to the "default" namespace.

  • -no-color: Disables colored command output. Alternatively, NOMAD_CLI_NO_COLOR may be set. This option takes precedence over -force-color.

  • -force-color: Forces colored command output. This can be used in cases where the usual terminal detection fails. Alternatively, NOMAD_CLI_FORCE_COLOR may be set. This option has no effect if -no-color is also used.

  • -ca-cert=<path>: Path to a PEM encoded CA cert file to use to verify the Nomad server SSL certificate. Overrides the NOMAD_CACERT environment variable if set.

  • -ca-path=<path>: Path to a directory of PEM encoded CA cert files to verify the Nomad server SSL certificate. If both -ca-cert and -ca-path are specified, -ca-cert is used. Overrides the NOMAD_CAPATH environment variable if set.

  • -client-cert=<path>: Path to a PEM encoded client certificate for TLS authentication to the Nomad server. Must also specify -client-key. Overrides the NOMAD_CLIENT_CERT environment variable if set.

  • -client-key=<path>: Path to an unencrypted PEM encoded private key matching the client certificate from -client-cert. Overrides the NOMAD_CLIENT_KEY environment variable if set.

  • -tls-server-name=<value>: The server name to use as the SNI host when connecting via TLS. Overrides the NOMAD_TLS_SERVER_NAME environment variable if set.

  • -tls-skip-verify: Do not verify TLS certificate. This is highly not recommended. Verification will also be skipped if NOMAD_SKIP_VERIFY is set.

  • -token: The SecretID of an ACL token to use to authenticate API requests with. Overrides the NOMAD_TOKEN environment variable if set.

Examples

Display the status of a job:

$ nomad status exampleID            = exampleName          = exampleSubmit Date   = 08/28/17 23:01:39 UTCType          = servicePriority      = 50Datacenters   = dc1Status        = runningPeriodic      = falseParameterized = falseSummaryTask Group  Queued  Starting  Running  Failed  Complete  Lostcache       0       0         1        0       0         0Latest DeploymentID          = f5506391Status      = runningDescription = Deployment is runningDeployedTask Group  Desired  Placed  Healthy  Unhealthycache       1        1       0        0AllocationsID        Node ID   Task Group  Version  Desired  Status   Created Ate1d14a39  f9dabe93  cache       0        run      running  08/28/17 23:01:39 UTC

Display the status of an allocation:

$ nomad status e1d14a39ID                  = e1d14a39Eval ID             = cc882755Name                = example.cache[0]Node ID             = f9dabe93Job ID              = exampleJob Version         = 0Client Status       = runningClient Description  = <none>Desired Status      = runDesired Description = <none>Created At          = 08/28/17 23:01:39 UTCDeployment ID       = f5506391Deployment Health   = healthyTask "redis" is "running"Task ResourcesCPU        Memory           Disk     Addresses4/500 MHz  6.3 MiB/256 MiB  300 MiB  db: 127.0.0.1:21752Task Events:Started At     = 08/28/17 23:01:39 UTCFinished At    = N/ATotal Restarts = 0Last Restart   = N/ARecent Events:Time                   Type        Description08/28/17 23:01:39 UTC  Started     Task started by client08/28/17 23:01:39 UTC  Task Setup  Building Task Directory08/28/17 23:01:39 UTC  Received    Task received by client

Display the status of a deployment:

$ nomad status f5506391ID          = f5506391Job ID      = exampleJob Version = 0Status      = successfulDescription = Deployment completed successfullyDeployedTask Group  Desired  Placed  Healthy  Unhealthycache       1        1       1        0

Display the status of a node:

$ nomad status f9dabe93ID      = f9dabe93Name    = nomad-server01Class   = <none>DC      = dc1Drain   = falseStatus  = readyDrivers = docker,exec,java,qemu,raw_exec,rktUptime  = 4h17m24sAllocated ResourcesCPU           Memory           Disk500/8709 MHz  256 MiB/2.0 GiB  300 MiB/24 GiBAllocation Resource UtilizationCPU         Memory3/8709 MHz  6.3 MiB/2.0 GiBHost Resource UtilizationCPU           Memory           Disk116/8709 MHz  335 MiB/2.0 GiB  12 GiB/38 GiBAllocationsID        Node ID   Task Group  Version  Desired  Status   Created Ate1d14a39  f9dabe93  cache       0        run      running  08/28/17 23:01:39 UTC