Run Commands

View as Markdown

Inspect trace spans and events, or stream both live.

Output formatting flags (--json, --jq, and --template) are documented once in Output Formatting and are omitted from the tables below.

bctrl runs list

List runs

$bctrl runs list [flags]
FlagDescription
-L, --limit <number>Maximum number of results to return
--cursor <cursor>Pagination cursor

bctrl runs get

Get a run

$bctrl runs get <runId>

bctrl runs trace

List run trace spans

$bctrl runs trace <runId> [flags]
FlagDescription
-L, --limit <number>Maximum number of results to return
--cursor <cursor>Pagination cursor

bctrl runs events

List run events

$bctrl runs events <runId> [flags]
FlagDescription
-L, --limit <number>Maximum number of results to return
--cursor <cursor>Pagination cursor

bctrl runs stream

Stream trace spans and events from a run

$bctrl runs stream <runId> [flags]
FlagDescription
--after <cursor>Resume after a stream cursor
--include <kind>trace or events