Skip to content

Commit 2ac3688

Browse files
committed
Simplify monitoring docs and remove unnecessary sections
1 parent 5ba5218 commit 2ac3688

2 files changed

Lines changed: 2 additions & 26 deletions

File tree

modules/ai-agents/pages/mcp/remote/manage-servers.adoc

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -80,10 +80,8 @@ curl -X POST "https://<dataplane-api-url>/v1/redpanda-connect/mcp-servers/<mcp-s
8080
--
8181
=====
8282

83-
[NOTE]
84-
====
83+
8584
While stopped, the server does not respond to MCP requests. Start it again to restore service.
86-
====
8785

8886
== Start a stopped MCP server
8987

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

Lines changed: 1 addition & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ Every Remote MCP server automatically emits OpenTelemetry traces to a topic call
77

88
You must have an existing MCP server. If you do not have one, see xref:ai-agents:mcp/remote/quickstart.adoc[].
99

10-
== Understanding the traces topic
10+
== OpenTelemetry traces topic
1111

1212
When you create an MCP server, Redpanda automatically creates the `redpanda.otel_traces` topic in your cluster. This topic stores OpenTelemetry span data in JSON format, following the https://opentelemetry.io/docs/specs/otel/protocol/[OpenTelemetry Protocol (OTLP)] specification.
1313

@@ -228,7 +228,6 @@ Link MCP server activity to downstream effects:
228228

229229
The `redpanda.otel_traces` topic uses standard OpenTelemetry format, making it compatible with popular observability platforms.
230230

231-
232231
=== Grafana Cloud
233232

234233
Export traces to Grafana Cloud's managed Tempo service:
@@ -284,24 +283,3 @@ Forward traces to Datadog APM:
284283
. Convert to Datadog trace format.
285284
. View in Datadog APM with full correlation.
286285

287-
=== Custom dashboards
288-
289-
Build custom monitoring dashboards:
290-
291-
. Consume traces into your data warehouse (ClickHouse, PostgreSQL)
292-
. Aggregate metrics: request rates, error rates, latencies
293-
. Create alerts based on SLOs (Service Level Objectives)
294-
. Track MCP server health and usage patterns
295-
296-
== Best practices
297-
298-
* **Retention**: Configure appropriate retention for `redpanda.otel_traces` based on your compliance and debugging needs.
299-
* **Sampling**: For high-volume servers, implement sampling in your observability pipeline to reduce storage costs.
300-
* **Alerting**: Set up alerts for error rates, latency spikes, and unusual activity patterns.
301-
* **Correlation**: Tag traces with request IDs to correlate MCP activity with application behavior.
302-
* **Privacy**: Be aware that trace data may contain sensitive information from tool inputs and outputs.
303-
304-
[TIP]
305-
====
306-
Start with a simple dashboard showing request rate and error rate. Gradually add more sophisticated metrics like latency percentiles and tool-specific performance breakdowns as you understand your MCP server's usage patterns.
307-
====

0 commit comments

Comments
 (0)