Files
kumomta/docs/reference/kcli/inspect-ready-q.md
Wez Furlong 41291a4afb docs: mark generated pages with an @generated marker
The documentation generators now stamp each page they emit with an
@generated comment so that tooling can tell generated pages apart from
hand-written ones. Update the table-of-contents generator to skip YAML
front matter when picking a page title, since the marker is now stored
there.
2026-10-05 13:22:26 +01:00

1.1 KiB

tags
tags
ops
debugging

kcli inspect-ready-q

Returns information about a ready queue: its egress identity, effective state (throttles, suspensions, ready and connection counts), and, optionally, the dispatcher tasks that are currently handling its connections plus the egress path configuration in effect

Usage: kcli inspect-ready-q [OPTIONS] <QUEUE_NAME>

Arguments

  • <QUEUE_NAME> — The name of the ready queue to inspect

Options

  • --connections — Show the per-connection dispatcher state (phase, time in phase, message counters, etc.). Off by default since a busy queue can have many dispatchers

  • --config — Include the egress path configuration snapshot. Off by default because the config can be large

  • --sched-q — Include the list of scheduled queues that currently feed this ready queue. Off by default; can be expensive on ready queues with high fan-in

  • --json — Output the response as pretty-printed JSON. Mutually exclusive with the other flags; the JSON output always carries the full payload