用途:处理一切与请求相关的问题,如延迟、p99/p95、错误率、HTTP 方法、状态码、端点、服务间调用与下游依赖。日志行与 panic 请改用 kubesense-logs。使用前需部署 KubeSense MCP 服务器,工具按 traces 模块做 RBAC 校验。
主要工具:get-trace-or-log-fields(signal: "traces")应始终先调用;analyze-traces 做延迟百分位、错误率、计数与趋势;search-traces 读取单个跨度;get-distributed-trace 在有 trace_id 时还原完整调用链。字段只接受目录标签,如 service、instance、method、status_code、resource、role、protocol,存储列名会被拒绝。service 适合应用身份识别,workload 仅在需要 Kubernetes 拓扑时使用。
关键限制:过滤 duration 用毫秒、聚合 duration 返回纳秒,报告毫秒需除以 1e6,不存在 duration_ms 字段。traces 上 @attr 过滤无效,应使用 is_attribute: true。枚举值小写(status = error、role = server);status_code 是字符串,需枚举或 LIKE "5%",不能用范围比较。计数请求时加 role = server 以避免客户端跨度重复计数。value_operation 用 row_count。get-distributed-trace 需窗口覆盖 trace 的 start_timestamp,默认 max_spans 200、上限 500。traces 无法穷尽翻页,因 observation_point 无法固定,建议缩短窗口或改用分析。