Evaluations
expanso-cli evaluation
Manage evaluations
Synopsis
View scheduling evaluations in Expanso (control plane only).
What Is An Evaluation?
An evaluation is the scheduler's decision about where a job should run. Evaluations are automatically created when: • A new job is deployed • An existing job is updated • A node joins or leaves the cluster • An execution fails and needs rescheduling
The evaluation determines which nodes match the job's selector and creates executions on those nodes.
Evaluation States:
• blocked: Waiting for resources or dependencies • pending: Queued for scheduling • complete: Successfully scheduled • failed: Could not schedule (no matching nodes, constraints not met) • canceled: Manually cancelled or superseded by newer evaluation
When To Check Evaluations:
Most users don't need to interact with evaluations directly - they happen automatically in the background. Check evaluations when: • A job isn't running where you expect • You want to understand why a job was placed on specific nodes • Troubleshooting scheduling issues
Common Workflows:
List all evaluations
expanso-cli evaluation list
List evaluations for a specific job
expanso-cli job evaluations log-processor
View evaluation details
expanso-cli evaluation describe eval-abc-123
Options
-h, --help help for evaluation
Options inherited from parent commands
--auth-token string API bearer authentication token
-e, --endpoint string API endpoint URL
-k, --insecure Skip TLS certificate verification
-p, --profile string Profile to use for configuration
--timeout string Request timeout duration
-v, --verbose Enable verbose logging
SEE ALSO
- expanso-cli - Expanso CLI - Command-line interface for Expanso
- expanso-cli evaluation describe - Show detailed information about an evaluation
- expanso-cli evaluation list - List evaluations