Agentic Data Plane

rpk ai trace get

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

<trace> is the trace ID (as rpk ai trace list prints it), traces/<id>, or an Agentic Data Plane UI trace link, which also supplies the start time. --start-time (the trace’s start, from rpk ai trace list -o json) makes the read faster. -o json and -o yaml print the GetTraceResponse.

Exit codes: 0 on success; 4 with --fail-on-error when the trace ended in error or incomplete; 1 on an error; 3 when not authenticated.

This command was introduced in ai version 0.2.94.

Usage

rpk ai trace get <trace> [flags]

Examples

This section provides examples of how to use rpk ai trace get.

rpk ai trace get 4623d104a1415a48987e2659e9a9131b
rpk ai trace get 40f7588e6ac9dc8b01fb38c03dcd1d97 --fail-on-error -o json > trace.json

Flags

Value Type Description

--fail-on-error

bool

exit 4 when the trace ended in error or incomplete. (New in 0.2.100)

--start-time

string

the trace’s start time (RFC 3339), so the server can skip older history.

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.