Agentic Data Plane

rpk ai trace

Read the traces of agent runs and of calls only the AI gateway saw.

list finds traces, get prints one trace’s summary, span list its spans, and span get one span’s content. Listing needs dataplane_adp_trace_list; reading a trace needs dataplane_adp_trace_get, and its content is redacted where you may not read it.

This command was introduced in ai version 0.2.94.

Usage

rpk ai trace [flags]

Subcommands

Command Description

rpk ai trace get

Read one trace and print its summary. rpk ai trace span list prints its spans.

rpk ai trace list

List traces of agent runs and AI gateway calls, newest first unless --order-by says otherwise. The filter flags build ListTraces' AIP-160 filter: values within one flag are ORed, different flags are ANDed, and --filter is ANDed with all of them.

rpk ai trace span

Read a trace’s spans (list, get).

Global flags

Value Type Description

--config

string

Redpanda or rpk config file; default search paths are ~/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml.

-X, --config-opt

stringArray

Override rpk configuration settings; -X help for detail or -X list for terser detail.

--ignore-profile

bool

Ignore rpk.yaml and redpanda.yaml; use default settings.

--profile

string

rpk profile to use.

-v, --verbose

bool

Enable verbose logging.