Stado

CLI reference / waits / measured

stado waits measured

Invocation

stado waits measured [OPTIONS]

Purpose

Every operation that completed a wait on this machine with the longest completed wait on it, longest first: the measurement each later wait on that operation is due by, and the one place to see which operations take long here. With --over SECONDS only those whose longest wait exceeded it

Required inputs and options

Input or optionContract
--over <OVER>Only operations whose longest completed wait exceeded this many seconds
--jsonEmit the measurements as JSON

Output and state effect

This is an inspection/reporting operation. It reads the measured waits (`$STADO_WAITS_MEASURED_DIR`, else ~/.stado/waits-measured) and changes nothing.

Refusals

  • Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.
  • the measured waits cannot be found: neither STADO_WAITS_MEASURED_DIR nor HOME is set, so the measured waits have no directory
  • the measured waits cannot be read: <the record or directory that could not be read, and why>