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/mcp/remote/monitor-activity.adoc
+29-2Lines changed: 29 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -23,6 +23,33 @@ Each span represents a unit of work performed by your MCP server, such as:
23
23
* Error conditions
24
24
* Performance metrics
25
25
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
+
26
53
== Consume trace data
27
54
28
55
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:
107
134
108
135
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
136
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`).
112
139
* Child spans reference their parent via `parentSpanId` and share the same `traceId`
113
140
114
141
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