Skip to main content

List evaluations

GET 
/evaluations

Returns evaluations showing scheduler decisions about job placement.

What are Evaluations?​

Evaluations are created when jobs are deployed or updated. They represent the scheduler's decision-making process about which nodes should run a job. Each evaluation:

  • Analyzes the job's selector and finds matching nodes
  • Creates, updates, or stops executions based on desired vs actual state
  • Tracks what triggered it (job-create, job-update, node-update, etc.)
  • Has a lifecycle: pending → complete/failed/blocked

Filtering​

  • job_id: Show evaluations for a specific job
  • states: Filter by evaluation state (pending, complete, failed, blocked)
  • namespace: Filter by namespace (if multi-tenant)

When to Use​

  • Troubleshooting: "Why isn't my job running on expected nodes?"
  • Debugging: See scheduler decisions and any placement constraints
  • Monitoring: Track evaluation state (find blocked or failed evaluations)
  • Auditing: Understand what triggered scheduling decisions

Common Workflows​

  • Check why job isn't scheduling: GET /jobs/{id}/evaluations
  • Find blocked evaluations: ?states=blocked
  • See recent scheduling activity: ?order_by=created_at&order=desc
  • Track specific job's evaluations: ?job_id=job-abc123

Evaluation States​

  • pending: Waiting to be processed by scheduler
  • complete: Successfully processed, executions created/updated/stopped
  • failed: Scheduler encountered an error
  • blocked: Cannot proceed (e.g., no nodes match selector)
  • canceled: Job was deleted or stopped before evaluation completed
  • GET /jobs/{id}/evaluations - Evaluations for a specific job
  • GET /evaluations/{id} - Details about one evaluation

Request​

Responses​

OK