You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: modules/ai-agents/pages/observability/view-transcripts.adoc
+19-35Lines changed: 19 additions & 35 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,20 +1,26 @@
1
1
= View Transcripts
2
-
:description: Learn how to filter, search, and navigate the Transcripts interface to investigate agent execution traces using multiple detail views and interactive timeline navigation.
2
+
:description: Learn how to filter and navigate the Transcripts interface to investigate agent execution traces using multiple detail views and interactive timeline navigation.
3
3
:page-topic-type: how-to
4
4
:personas: agent_developer, platform_admin
5
-
:learning-objective-1: Filter and search transcripts to find specific execution traces
5
+
:learning-objective-1: Filter transcripts to find specific execution traces
6
6
:learning-objective-2: Navigate between detail views to inspect span information at different levels
7
7
:learning-objective-3: Use the timeline interactively to navigate to specific time periods
8
8
9
-
The Transcripts view provides filtering, searching, and navigation capabilities for investigating agent and MCP serverexecution transcripts. Use these features to efficiently locate specific operations, analyze performance patterns, and debug issues across tool invocations, LLM calls, and agent reasoning steps.
9
+
The Transcripts view provides filteringand navigation capabilities for investigating agent, MCP server, and AI Gateway execution glossterm:transcript[transcripts]. Use this view to quickly locate specific operations, analyze performance patterns, and debug issues across glossterm:tool[] invocations, LLM calls, and glossterm:agent[] reasoning steps.
10
10
11
11
After reading this page, you will be able to:
12
12
13
13
* [ ] {learning-objective-1}
14
14
* [ ] {learning-objective-2}
15
15
* [ ] {learning-objective-3}
16
16
17
-
For basic orientation on agent and MCP server monitoring, see xref:ai-agents:agents/monitor-agents.adoc[] or xref:ai-agents:mcp/remote/monitor-mcp-servers.adoc[]. For conceptual background on what transcripts capture and how spans are organized hierarchically, see xref:ai-agents:observability/concepts.adoc[].
17
+
For basic orientation on monitoring each Redpanda Agentic Data Plane component, see:
For conceptual background on what transcripts capture and how glossterm:span[spans] are organized hierarchically, see xref:ai-agents:observability/concepts.adoc[].
18
24
19
25
== Prerequisites
20
26
@@ -27,37 +33,17 @@ For basic orientation on agent and MCP server monitoring, see xref:ai-agents:age
27
33
28
34
Use the timeline visualization to quickly identify when errors began or patterns changed, and navigate directly to transcripts from particular timestamps.
29
35
30
-
When viewing time periods with many transcripts (hundreds or thousands), the timeline displays a subset of the data to maintain performance and usability. The timeline bar indicates the actual time range of currently visible data, which may be narrower than your selected range.
36
+
When viewing time periods with many transcripts (hundreds or thousands), the timeline displays a subset of the data to maintain performance and usability. The timeline bar indicates the actual time range of currently visible data, which may be narrower than your <<adjust-time-range,selected time range>>.
31
37
32
38
TIP: See xref:ai-agents:agents/monitor-agents.adoc[] and xref:ai-agents:mcp/remote/monitor-mcp-servers.adoc[] to learn basic execution patterns and health indicators to investigate.
33
39
34
-
=== Search and filter for transcripts
35
-
36
-
Use search and filters together to narrow down transcripts and quickly locate specific executions.
37
-
38
-
==== Search for specific transcripts
40
+
=== Filter transcripts
39
41
40
-
The search functionality helps you find transcripts by operation names, span types, or identifiers:
42
+
Use filters to narrow down transcripts and quickly locate specific executions. When you use any of the filters, the transcript list updates to show only matching results. You can toggle *Full transcript* on to see the complete execution context, in grayed-out text, for the filtered transcripts.
41
43
42
-
* Search by span names to find specific xref:ai-agents:observability/concepts.adoc#agent-span-types[agent operations] like `invoke_agent`, or xref:ai-agents:mcp/remote/create-tool.adoc[MCP tools]
43
-
* Search by xref:ai-agents:observability/concepts.adoc#instrumentation-layers[scope] to filter by layer (for example, `rpcn-mcp` for MCP tool spans)
44
-
* Search by trace IDs (`traceId`) when correlating with external systems or troubleshooting specific requests
44
+
==== Filter by attribute
45
45
46
-
==== Filter by service
47
-
48
-
Service filtering shows only transcripts from specific agents or MCP servers using the `service.name` resource attribute. See xref:ai-agents:observability/concepts.adoc#cross-service-transcripts[Cross-service transcripts] to understand how transcripts span multiple services.
49
-
50
-
* View executions from a single agent when multiple are running (service name: `ai-agent`)
51
-
* Isolate MCP server activity from agent activity (service name: `mcp-{server-id}`)
52
-
* Compare behavior across different service instances
53
-
54
-
==== Filter by execution status
55
-
56
-
Status filtering shows transcripts based on their execution outcome:
57
-
58
-
* Show successful executions for health checks
59
-
* Show only failed executions for error investigation
60
-
* Toggle between success and error views to compare and analyze patterns
46
+
// Add details when available
61
47
62
48
==== Adjust time range
63
49
@@ -67,15 +53,13 @@ Use the time range selector to focus on specific time periods (from the last fiv
67
53
* Expand to longer periods for trend analysis over the last day
68
54
* Narrow to specific time windows when investigating issues that occurred at known times
69
55
70
-
TIP: Apply broad filters first (time range, service) to reduce the transcript set, then use search to narrow to specific operations.
71
-
72
56
== Inspect span details
73
57
74
-
Each row in the transcript table represents a high-level agent or MCP server request flow. Expand each parent span to see the xref:ai-agents:observability/concepts.adoc#agent-transcript-hierarchy[hierarchical structure] of nested operations, including tool calls, LLM interactions, and internal processing steps. Parent-child spans show how operations relate: for example, an agent invocation (parent) triggers LLM calls and tool executions (children).
58
+
Each row in the transcript table represents a high-level agent or MCP server request flow. Expand each parent glossterm:span[] to see the xref:ai-agents:observability/concepts.adoc#agent-transcript-hierarchy[hierarchical structure] of nested operations, including tool calls, LLM interactions, and internal processing steps. Parent-child spans show how operations relate: for example, an agent invocation (parent) triggers LLM calls and tool executions (children).
75
59
76
-
When agents invoke remote MCP servers, transcripts fold together across service boundaries to provide a unified view of the complete operation. The trace ID originates at the initial request touchpoint and propagates across all involved services, linking spans from both the agent and MCP server under a single transcript. Use the tree view to follow the trace flow across multiple services and understand the complete request lifecycle.
60
+
When agents invoke remote MCP servers, transcripts fold together under a tree structure to provide a unified view of the complete operation across service boundaries. The glossterm:trace ID[] originates at the initial request touchpoint and propagates across all involved services, linking spans from both the agent and MCP server under a single transcript. Use the tree view to follow the trace flow across multiple services and understand the complete request lifecycle.
77
61
78
-
If you use external agents that directly invoke MCP servers in the Redpanda Agentic Data Plane, you may only see MCP-level parent transcripts, unless you have configured the agents to also emit traces to the Redpanda OTEL ingestion pipeline.
62
+
If you use external agents that directly invoke MCP servers in the Redpanda Agentic Data Plane, you may only see MCP-level parent transcripts, unless you have configured the agents to also emit traces to the Redpanda glossterm:OpenTelemetry[OTEL] ingestion pipeline.
79
63
80
64
Selected spans display detailed information at multiple levels, from high-level summaries to complete raw data:
81
65
@@ -100,7 +84,7 @@ TIP: Expand the summary panel to full view to easily read long conversations.
100
84
101
85
=== Detailed attributes view
102
86
103
-
The attributes view shows structured metadata for each transcript span. Use this view to quickly locate an attribute value such as conversation ID, then paste it into the search box to find all operations from that conversation session. See xref:ai-agents:observability/concepts.adoc#key-attributes-by-layer[Transcripts and AI Observability] for details on standard attributes by instrumentation layer.
87
+
The attributes view shows structured metadata for each transcript span. Use this view to inspect span attributes and understand the context of each operation. See xref:ai-agents:observability/concepts.adoc#key-attributes-by-layer[Transcripts and AI Observability] for details on standard attributes by instrumentation layer.
0 commit comments