CLI command
probierz durations scan
List every operation Wisent programs waited on, on this machine, that took longer than the threshold.
Invocation#
probierz durations scan [--over <seconds>]Required inputs and options#
- The threshold is
--over(whole seconds), else this instance'sdurations.slow-seconds(probierz config set durations.slow-seconds <seconds>). - The operations are Stado's measured waits: every child process, request, lock and channel a program built on Stado's wait mechanism waited on here, each with its longest completion, read through Stado's own command (
stado waits measured --over <seconds> --json), never from Stado's files. No harness or manifest is read.
Output and state effects#
Reads only. Writes {threshold, source, directory, operations: [{operation, seconds}]}, the operations longest first, source the Stado command it read and directory the measurement directory Stado named.
Exact refusals#
threshold-unset(exit 1): neither--overnordurations.slow-secondsnames a threshold; nothing is read.register-unread(exit 69): Stado could not be started, exited other than 0, or answered no JSON with ameasuredlist; the refusal names the command, its exit status and what it wrote on standard error. Real test: tests/durations/durations.rs.
Declared refusals#
What probierz refusals list declares for this command at revision d2cd6156e8b8dc6204dab7b46ec0b34b2bb03cea (probierz 0.1.7 (revision unknown, not built from a git checkout)): each cause's id, the operation declaring it, its exit status and code, and its remedy.
threshold-unset(probierz.durations, exit 1, config): {doing}: no threshold names how long an operation may take before it counts as slow: neither --over nor this instance's durations.slow-seconds is set. set the threshold withprobierz config set durations.slow-seconds <seconds>, or name it with --over.register-unread(probierz.durations, exit 69, infra_down): reading the waits Stado measured on this machine ({command}): {why}. install Stado where PATH finds it (stado --version), then repair what its answer names;stado waits measured --jsonis the reading.name-invalid(probierz.durations, exit 2, refused): naming the operation {name}: an operation's name is lowercase letters, digits,.,-and_, starting with a letter or digit, so it is one directory of the kept measurements. name it likeoko-defects-list.runs-invalid(probierz.durations, exit 2, refused): measuring {name} {runs} time(s): a measurement runs the operation at least once. pass --runs with a whole number above zero.cwd-invalid(probierz.durations, exit 2, refused): running {name} in {cwd}: the directory an operation runs in is absolute and exists, so every measurement of it runs in the same place. pass --cwd with an absolute directory that exists.command-changed(probierz.durations, exit 2, refused): measuring {name} as {command} in {cwd}: {name} was first measured as {first} in {first_cwd}; an optimization changes the code a command runs, not the command, so its measurements compare only while the command stays. measure it with its first command, or name the new command another operation.program-missing(probierz.durations, exit 1, config): finding the program {program} of {name}: {why}. name the program by a path that exists, or install it where PATH finds it.run-failed(probierz.durations, exit 1, config): run {run} of {runs} of {name} ({command}): {status}, and a command that fails measures nothing. make the command succeed in {cwd}, then measure it again.measurement-unreadable(probierz.durations, exit 1, config): reading the kept measurement {file}: {why}. remove the file, or put back the measurementprobierz durations measurewrote.measurement-unknown(probierz.durations, exit 2, refused): finding {what}: no measurement is kept under that name or id. name oneprobierz durations list(orshow <name>) shows.reduction-unset(probierz.durations, exit 1, config): deciding whether {name} was cut by the share this instance requires: this instance's durations.reduction is unset, so no share decides it. set the share withprobierz config set durations.reduction <share>.baseline-missing(probierz.durations, exit 1, config): comparing {name} with its first measurement: {name} was measured once, so nothing is there to compare it with. measure it again after the optimization:probierz durations measure {name} …with its first command.not-reduced(probierz.durations, exit 1, config): cutting the time of {count} operation(s) by {reduction}: their median is above {required} of their first measurement's. optimize what each named operation spends its time on, then measure it again.
Source snapshot#
Generated from the Rust binaries at revision 99a74945a3598a8d73b6c6cbe5aae4f283becea3 of Probierz's private source repository.
Combined help SHA-256: 77529678a61237f774b59e76df0d1907cb749ef5da56d2ed913b040793b7d30b; binary SHA-256: be9e0eaff0e6ea50403a0c6f6d467697a4eac676f9523b8dc13a596d2b5526c5.