Skip to content

Commit 482be19

Browse files
committed
Add trace topic configuration and lifecycle details
1 parent 96348ff commit 482be19

1 file changed

Lines changed: 29 additions & 2 deletions

File tree

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

Lines changed: 29 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,33 @@ Each span represents a unit of work performed by your MCP server, such as:
2323
* Error conditions
2424
* Performance metrics
2525

26+
=== Topic configuration and lifecycle
27+
28+
The `redpanda.otel_traces` topic is managed automatically by Redpanda and follows a predefined retention policy. Configuration changes to this system-managed topic are not supported and will be reconciled back to the default settings.
29+
30+
The topic persists in your cluster even after all MCP servers are deleted, allowing you to retain historical trace data for analysis.
31+
32+
You can create xref:security:authorization/acl.adoc[ACLs] to control access to the `redpanda.otel_traces` topic using standard Redpanda ACL operations.
33+
34+
Trace data may contain sensitive information from your tool inputs and outputs. Consider implementing appropriate access controls and review the data in traces before sharing or exporting to external systems.
35+
36+
=== Traces compared to audit logs
37+
38+
OpenTelemetry traces are designed for observability and debugging, not audit logging or compliance:
39+
40+
Traces provide:
41+
42+
* Hierarchical view of request flow through your system (parent-child span relationships)
43+
* Detailed timing information for performance analysis
44+
* Ability to reconstruct execution paths and identify bottlenecks
45+
* Insights into how operations flow through distributed systems
46+
47+
Traces are not:
48+
49+
* Immutable audit records for compliance purposes
50+
* Guaranteed to capture every action (traces can be sampled or dropped under load)
51+
* Designed for "who did what" accountability tracking
52+
2653
== Consume trace data
2754

2855
You can consume traces from the `redpanda.otel_traces` topic using any Kafka-compatible client or the Redpanda Console.
@@ -107,8 +134,8 @@ Each trace message contains an OpenTelemetry span with the following structure:
107134

108135
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:
109136

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`)
137+
* When `instrumentationScope.name` is `rpcn-mcp`, the span represents an MCP tool invocation.
138+
* The `name` field contains the MCP tool name (for example, `weather`, `http_processor`, `generate_input`).
112139
* Child spans reference their parent via `parentSpanId` and share the same `traceId`
113140

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

0 commit comments

Comments
 (0)