用途:通过 KubeSense MCP 工具查询和分析 Kubernetes 集群中的分布式追踪数据,覆盖字段发现、原始 Span 检索、延迟与错误分析。
主要能力:提供三个工具——get-trace-or-log-fields(发现可用字段)、search-traces(浏览原始追踪/Span 记录,最多 10 行)、analyze-traces(对追踪执行聚合分析)。内置字段包括 status、protocol_type、duration、duration_ms、workload、namespace、cluster、pod_name、node_name、role、subtype、return_code、server、client、operation_name、clustered_resource、source 等。
使用方式:遵循“先发现再查询”规则,先用 get-trace-or-log-fields 获取字段,再调用 search-traces 或 analyze-traces。所有工具需提供 ISO 8601 格式的 from_time 与 to_time,建议从 15–30 分钟窄窗口开始。filters 支持类 SQL 的 WHERE 子句,可用 =、!=、>、<、>=、<=、IN、NOT IN、LIKE、NOT LIKE,并以 AND/OR 组合。聚合函数包括 row_count、unique_count、avg、sum、min、max 及 p99/p95/p90/p75/p50。queryType 可选 range(时间序列趋势)或 instant(单点快照)。
限制:duration 为纳秒,仅用于聚合与分组,不可用于过滤;过滤延迟须使用 duration_ms(毫秒),该字段不被字段发现返回但可直接过滤。字符串须用单引号,数字不加引号。search-traces 最多返回 10 行。其余收费、平台与效果信息暂未提供。