---
title: rpk ai trace get
latest-operator-version: v26.2.6
latest-console-tag: v3.14.0
latest-connect-version: 4.118.0
latest-redpanda-tag: v26.2.7
docname: rpk/rpk-ai/rpk-ai-trace-get
page-component-name: agentic-data-plane
page-version: master
page-component-version: master
page-component-title: Agentic Data Plane
page-relative-src-path: rpk/rpk-ai/rpk-ai-trace-get.adoc
page-edit-url: https://github.com/redpanda-data/adp-docs/edit/main/modules/reference/pages/rpk/rpk-ai/rpk-ai-trace-get.adoc
description: Read one trace and print its summary. <code>rpk ai trace span list</code> prints its spans.
page-git-created-date: "2026-10-26"
page-git-modified-date: "2026-10-26"
page-generated-sources:
  - include: streaming:reference:partial$rpk-ai/rpk-ai-trace-get.adoc
    generator: rpk-docs
    version: null
    source: the rpk command help in redpanda-data/streaming-enterprise
page-generated-content: partial
---

# rpk ai trace get

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [agentic-data-plane-full.txt](https://docs.redpanda.com/agentic-data-plane-full.txt)

<!-- Source: https://docs.redpanda.com/agentic-data-plane/reference/rpk/rpk-ai/rpk-ai-trace-get.md -->

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.

> 📝 **NOTE**
>
> This command was introduced in ai version 0.2.94.

## Usage

```bash
rpk ai trace get <trace> [flags]
```

## Examples

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

```bash
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. |