@@ -256,37 +256,37 @@ This trace shows an HTTP request that encountered an error during execution:
256256
257257Monitor which tools are being called and how often:
258258
259- . Consume traces from `redpanda.otel_traces`
260- . Filter spans where `name` contains `tool_invocation`
261- . Examine the `mcp.tool.name` attribute to see which tools are being used
262- . Calculate frequency by counting spans per tool name over time windows
259+ . Consume traces from `redpanda.otel_traces`.
260+ . Filter spans where `name` contains `tool_invocation`.
261+ . Examine the `mcp.tool.name` attribute to see which tools are being used.
262+ . Calculate frequency by counting spans per tool name over time windows.
263263
264264=== Measure performance
265265
266266Analyze tool execution times:
267267
268- . Find spans with `mcp.tool.name` attributes
269- . Calculate duration: `(endTimeUnixNano - startTimeUnixNano) / 1000000` (milliseconds)
270- . Track percentiles (p50, p95, p99) to identify performance issues
271- . Set alerts for durations exceeding acceptable thresholds
268+ . Find spans with `mcp.tool.name` attributes.
269+ . Calculate duration: `(endTimeUnixNano - startTimeUnixNano) / 1000000` (milliseconds).
270+ . Track percentiles (p50, p95, p99) to identify performance issues.
271+ . Set alerts for durations exceeding acceptable thresholds.
272272
273273=== Debug failures
274274
275275Investigate errors and failures:
276276
277- . Filter spans where `status.code` is not `STATUS_CODE_OK`
278- . Look for `STATUS_CODE_ERROR` in the status field
279- . Examine `status.message` for error details
280- . Use `traceId` to correlate related spans and understand the full error context
277+ . Filter spans where `status.code` is not `STATUS_CODE_OK`.
278+ . Look for `STATUS_CODE_ERROR` in the status field.
279+ . Examine `status.message` for error details.
280+ . Use `traceId` to correlate related spans and understand the full error context.
281281
282282=== Correlate distributed operations
283283
284284Link MCP server activity to downstream effects:
285285
286- . Extract `traceId` from tool invocation spans
287- . Search for the same `traceId` in other application logs or traces
288- . Follow `parentSpanId` relationships to build complete operation timelines
289- . Identify bottlenecks across your entire system
286+ . Extract `traceId` from tool invocation spans.
287+ . Search for the same `traceId` in other application logs or traces.
288+ . Follow `parentSpanId` relationships to build complete operation timelines.
289+ . Identify bottlenecks across your entire system.
290290
291291== Integration with observability platforms
292292
0 commit comments