Skip to content

Commit 96348ff

Browse files
committed
Clarify how to identify MCP tools in shared traces topic
- Explain that all MCP servers write to the same redpanda.otel_traces topic - Document how to identify which tool by instrumentationScope and name fields - Clarify rpcn-mcp vs benthos naming for parent and child spans - Help customers filter traces in multi-server environments
1 parent c440a3c commit 96348ff

1 file changed

Lines changed: 10 additions & 0 deletions

File tree

modules/ai-agents/pages/mcp/remote/monitor-activity.adoc

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -103,6 +103,16 @@ Each trace message contains an OpenTelemetry span with the following structure:
103103
* `status`: Operation status with `code` (0 = OK, 2 = ERROR) and optional `message`.
104104
* `instrumentationScope`: Identifies the library or component that created the span.
105105

106+
=== Identifying MCP servers and tools
107+
108+
All MCP servers in a cluster write traces to the same `redpanda.otel_traces` topic. Each trace has a unique `traceId`, and you can identify which tool created the trace by examining the span fields:
109+
110+
* When `instrumentationScope.name` is `rpcn-mcp`, the span represents an MCP tool invocation
111+
* The `name` field contains the tool name (for example, `weather`, `http_processor`, `generate_input`)
112+
* Child spans reference their parent via `parentSpanId` and share the same `traceId`
113+
114+
For example, a span with `instrumentationScope.name: "rpcn-mcp"` and `name: "weather"` indicates the `weather` tool was invoked. Child spans created by Redpanda Connect components show `instrumentationScope.name: "benthos"` and represent internal processing steps.
115+
106116
=== Real trace examples
107117

108118
Here are actual traces from MCP tool executions showing the parent-child span relationships and detailed attributes.

0 commit comments

Comments
 (0)