hashicorp/nomad · error

unable to look up summary for job: %v

Error message

unable to look up summary for job: %v

What it means

While paginating jobs in a node pool listing, the state store failed to read (or returned nil for) a job summary; the error wraps that lookup failure during result transformation rather than indicating a bad request.

Source

Thrown at nomad/node_pool_endpoint.go:457

						if allowableNamespaces != nil && !allowableNamespaces[job.Namespace] {
							return false
						}
						if job.NodePool != args.Name {
							return false
						}
						return true
					}
				}
				if err != nil {
					return err
				}

				pager, err := paginator.NewPaginator(iter, args.QueryOptions, selector,
					paginator.NamespaceIDTokenizer[*structs.Job](args.NextToken),
					func(job *structs.Job) (*structs.JobListStub, error) {
						summary, err := store.JobSummaryByID(ws, job.Namespace, job.ID)
						if err != nil || summary == nil {
							return nil, fmt.Errorf("unable to look up summary for job: %v", job.ID)
						}
						return job.Stub(summary, args.Fields), nil
					})
				if err != nil {
					return structs.NewErrRPCCodedf(
						http.StatusBadRequest, "failed to create result paginator: %v", err)
				}

				jobs, nextToken, err := pager.Page()
				if err != nil {
					return structs.NewErrRPCCodedf(
						http.StatusBadRequest, "failed to read result page: %v", err)
				}

				reply.QueryMeta.NextToken = nextToken
				reply.Jobs = jobs
			}

View on GitHub (pinned to 482b49bf1a)

Solutions

1. Retry the list request; the read may have raced a state update
2. Check server logs for state store errors
3. Verify server/Raft health if the error persists

When it happens

Trigger: Thrown at nomad/node_pool_endpoint.go:457 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of hashicorp/nomad@482b49bf1a (2026-09-04). Data as JSON: /api/errors/028f7afe968a2858. Report an issue: GitHub.