Oko/Docs

Command reference

oko waits bottlenecks-threshold

Declares the total wait, in seconds over the pass's window, above which the policy pass records the fleet's longest wait as a class defect.

Invocation#

Command
oko waits bottlenecks threshold --seconds N --by SESSION [--json]

Inputs and options#

  • The number is the declaring session's; no threshold is assumed, so with none declared the pass records nothing and says so. A later declaration replaces the earlier one; the native API takes `bottleneck_threshold {seconds, by}` and Oko Desktop's Declare the threshold calls it.

Output and state effect#

  • Writes {seconds, by, at} to bottleneck-threshold.json in Oko's directory (`OKO_BOTTLENECK_THRESHOLD` moves it) and prints `threshold: the policy pass records the first position waiting more than <N>s in total`.

Refusals and safe exits#

  • A missing --seconds or --by is refused by name (exit 2); `a bottleneck threshold is a number of seconds, not <value>`.

CLI reference#