Orchestrator Commands

Inspect workflows, executions, metrics, and usage data for Skytells Orchestrator from the CLI.

The Orchestrator CLI commands give you visibility into automated workflow execution — without opening the Console. Use them in CI/CD pipelines to gate deployments on workflow health, or from a terminal to diagnose execution failures.

For a conceptual overview of the Orchestrator product, see Orchestrator.

Commands on this page

Command	Description
`skytells workflows ls`	List available workflows
`skytells orchestrator overview`	Aggregated execution stats
`skytells orchestrator executions`	List individual executions
`skytells orchestrator inspect`	Inspect a specific execution
`skytells orchestrator metrics`	Time-series performance metrics
`skytells orchestrator usage`	Resource consumption over a period

skytells workflows ls

Lists all workflows defined in the linked project.

Syntax

skytells workflows ls [--json]

Example

skytells workflows ls

┌──────────────┬────────────────────────┬────────────┐
│ ID           │ Name                   │ Trigger    │
├──────────────┼────────────────────────┼────────────┤
│ wf_001       │ data-ingestion         │ scheduled  │
│ wf_002       │ report-generator       │ webhook    │
│ wf_003       │ ml-inference-pipeline  │ manual     │
└──────────────┴────────────────────────┴────────────┘

skytells orchestrator overview

Returns an aggregated summary of workflow execution health: total runs, success rate, failure rate, and average duration.

Syntax

skytells orchestrator overview [--hours <n>] [--json]

Flags

Flag	Description
`--hours <n>`	Lookback window in hours. Default: `24`.
`--json`	Output as JSON.

Example

skytells orchestrator overview
skytells orchestrator overview --hours 72
skytells orchestrator overview --json | jq '.failure_rate'

skytells orchestrator executions

Lists individual execution records, with optional filtering by workflow and status.

Syntax

skytells orchestrator executions [--workflow <id>] [--status <status>] [--limit <n>] [--json]

Flags

Flag	Description
`--workflow <id>`	Filter by workflow ID.
`--status <status>`	Filter by status: `running`, `completed`, `failed`, `cancelled`.
`--limit <n>`	Number of results to return. Default: `20`.
`--json`	Output as JSON.

Examples

# All recent executions
skytells orchestrator executions

# Failures only
skytells orchestrator executions --status failed

# Executions for a specific workflow
skytells orchestrator executions --workflow wf_001 --limit 50

# Extract IDs of recent failures for investigation
skytells orchestrator executions --status failed --json | jq -r '.[].id'

skytells orchestrator inspect

Returns the full execution record for a single run — input, output, step trace, duration, and error details.

Syntax

skytells orchestrator inspect <id> [--json]

Example

skytells orchestrator inspect exec_abc123

# Get the error reason from a failed execution
skytells orchestrator inspect exec_abc123 --json | jq '.error'

skytells orchestrator metrics

Returns performance metrics over a time range as a time series.

Syntax

skytells orchestrator metrics [--from <date>] [--to <date>] [--json]

Flags

Flag	Description
`--from <date>`	Start date (ISO 8601 format, e.g. `2026-03-01`).
`--to <date>`	End date. Defaults to now.
`--json`	Output as JSON.

Example

skytells orchestrator metrics --from 2026-03-01 --to 2026-03-18
skytells orchestrator metrics --json | jq '.series[] | "\(.timestamp) \(.success_count) \(.failure_count)"'

skytells orchestrator usage

Returns resource consumption statistics over a period — compute time, execution counts, and costs.

Syntax

skytells orchestrator usage [--from <date>] [--to <date>] [--json]

Example

skytells orchestrator usage --from 2026-03-01 --to 2026-03-18
skytells orchestrator usage --json | jq '.total_compute_seconds'

Alert on failures in CI/CD

#!/bin/bash
# Fail the build if the orchestrator has a high failure rate
FAILURE_RATE=$(skytells orchestrator overview --json | jq '.failure_rate')
THRESHOLD=0.05  # 5%

if (( $(echo "$FAILURE_RATE > $THRESHOLD" | bc -l) )); then
  echo "Orchestrator failure rate $FAILURE_RATE exceeds threshold $THRESHOLD"
  exit 1
fi
echo "Orchestrator health OK"

How is this guide?

On this page