Skip to content

Commit b5b404c

Browse files
committed
Remove search and add placeholder for filtering functionality
1 parent 5e94aca commit b5b404c

File tree

1 file changed

+19
-35
lines changed

1 file changed

+19
-35
lines changed

modules/ai-agents/pages/observability/view-transcripts.adoc

Lines changed: 19 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,26 @@
11
= 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.
33
:page-topic-type: how-to
44
: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
66
:learning-objective-2: Navigate between detail views to inspect span information at different levels
77
:learning-objective-3: Use the timeline interactively to navigate to specific time periods
88

9-
The Transcripts view provides filtering, searching, and navigation capabilities for investigating agent and MCP server execution 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 filtering and 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.
1010

1111
After reading this page, you will be able to:
1212

1313
* [ ] {learning-objective-1}
1414
* [ ] {learning-objective-2}
1515
* [ ] {learning-objective-3}
1616
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:
18+
19+
* xref:ai-agents:ai-gateway/observability-metrics.adoc[]
20+
* xref:ai-agents:agents/monitor-agents.adoc[]
21+
* xref:ai-agents:mcp/remote/monitor-mcp-servers.adoc[]
22+
23+
For conceptual background on what transcripts capture and how glossterm:span[spans] are organized hierarchically, see xref:ai-agents:observability/concepts.adoc[].
1824

1925
== Prerequisites
2026

@@ -27,37 +33,17 @@ For basic orientation on agent and MCP server monitoring, see xref:ai-agents:age
2733

2834
Use the timeline visualization to quickly identify when errors began or patterns changed, and navigate directly to transcripts from particular timestamps.
2935

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>>.
3137

3238
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.
3339

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
3941

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.
4143

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
4545

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
6147

6248
==== Adjust time range
6349

@@ -67,15 +53,13 @@ Use the time range selector to focus on specific time periods (from the last fiv
6753
* Expand to longer periods for trend analysis over the last day
6854
* Narrow to specific time windows when investigating issues that occurred at known times
6955

70-
TIP: Apply broad filters first (time range, service) to reduce the transcript set, then use search to narrow to specific operations.
71-
7256
== Inspect span details
7357

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).
7559

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.
7761

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.
7963

8064
Selected spans display detailed information at multiple levels, from high-level summaries to complete raw data:
8165

@@ -100,7 +84,7 @@ TIP: Expand the summary panel to full view to easily read long conversations.
10084

10185
=== Detailed attributes view
10286

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.
10488

10589
=== Raw data view
10690

0 commit comments

Comments
 (0)