Sign in
latestOpenAPI 3.1.02026-08-19270462702.4 KB

b92f75fd3b61

observability

Get Observability Summary

Headline totals, previous-period trend, and daily spend series.

Separates total coding-harness spend from actual software-engineering spend (engineering_spend = total minus non_coding).

get/observability/summary

Query parameters

start_datestring nullable

Range start (ISO date or datetime, UTC). Defaults to 30 days ago.

Range start (ISO date or datetime, UTC). Defaults to 30 days ago.

end_datestring nullable

Range end (ISO date or datetime, UTC). Defaults to now.

Range end (ISO date or datetime, UTC). Defaults to now.

scope'team' | 'personal'

team (default) aggregates the active team's coding-agent tasks; personal narrows to tasks on keys the requesting user created.

team (default) aggregates the active team's coding-agent tasks; personal narrows to tasks on keys the requesting user created.

Response

Successful Response

total_spendnumber required
engineering_spendnumber required
non_coding_spendnumber required
routed_spendnumber

Spend served via the Pioneer model router (USD).

direct_spendnumber

Spend on raw direct-model calls that bypass the router (USD).

total_tokensinteger required
cache_read_tokensinteger

Sum of prompt-cache read tokens across the window. Dominant volume for coding harnesses; already stored on coding_agent_tasks.

cache_write_tokensinteger

Sum of prompt-cache write tokens across the window.

context_tokensinteger

input + cache_read + cache_write — total tokens the model had to read across the window. The honest volume number.

cache_hit_pctnumber nullable

cache_read / context_tokens in [0, 1]. Null when no context.

context_amplificationnumber nullable

context_tokens / output_tokens. Null when either side is zero.

cost_per_1k_outputnumber nullable

USD per 1,000 generated tokens. Null when no output tokens.

session_wall_ms_p50integer

Median session duration_ms (one-shots excluded — they have duration_ms = 0 by construction).

session_wall_ms_p90integer

90th-percentile session duration_ms (one-shots excluded).

total_wall_msinteger

Sum of duration_ms over session tasks. Additive base measure used as the denominator of any future duty-cycle metric.

active_msinteger

Sum of inferences.latency_ms — model compute time in ms. Trust degrades with latency_coverage.

duty_cyclenumber nullable

active_ms / total_wall_ms over sessions. High => autonomous loop; low => human-in-the-loop. Null when no session wall time.

output_throughput_per_snumber nullable

output_tokens / (active_ms / 1000) — model tokens per second across the window. Null when no active_ms.

cost_per_active_minutenumber nullable

total_cost / (active_ms / 60000) USD per minute of model time.

latency_coveragenumber nullable

latency_sample_count / request_count — trust indicator for time-derived metrics. Null when no requests.

task_countinteger required
session_countinteger required
one_shot_countinteger required
active_keysinteger required
active_harnessesinteger required
previous_total_spendnumber required

Total spend over the immediately preceding window of equal length.

spend_trend_pctnumber nullable

Percent change vs previous period; null when previous is zero.