Skip to main content

Get an evaluation

GET 
/evaluations/:id

Returns detailed information about a specific scheduler evaluation.

What You Get​

  • Evaluation ID, job ID, and namespace
  • What triggered this evaluation (job-create, job-update, node-update, etc.)
  • Current state (pending, complete, failed, blocked)
  • Status message explaining the outcome
  • Priority (higher priority evaluations are processed first)
  • Timestamps (created, updated)

When to Use​

  • Investigate why a job isn't scheduling (check state and message)
  • Debug blocked evaluations (see why scheduler couldn't proceed)
  • Verify evaluation completion after job deployment
  • Understand scheduling timeline (created_at to updated_at)

Understanding the Outcome​

  • complete + "Scheduled on N nodes": Success, executions created
  • complete + "No changes needed": Job already at desired state
  • blocked + "No nodes match selector": Need to check node labels
  • failed + error message: Scheduler error, contact support

Troubleshooting with Evaluations​

If a job isn't running:

  1. GET /jobs/{id}/evaluations - Find the latest evaluation
  2. Check its state and message
  3. If blocked: Verify nodes exist with matching labels
  4. If failed: Check the error message for root cause

Request​

Responses​

OK