SuperAPI AI 工具集

trace-analytics

数据与分析

查看项目

更新于 10-16 03:11

技能介绍

用途:这是一个 OpenSearch 追踪分析技能,帮助用户调查分布式 trace、分析 span 性能、调试错误并理解服务依赖关系,也可分析 GenAI 的 agent 调用、工具执行与 token 用量。

主要能力:发现 trace 索引(spans 通常在 otel-v1-apm-span-,服务拓扑在 otel-v2-apm-service-map-);按意图构造 PPL 查询,包括 agent 调用(attributes.gen_ai.operation.name = invoke_agent)、工具执行(execute_tool)、慢 span(durationInNanos 阈值)、错误 span(status.code = 2)、按模型或 agent 聚合 token、按 traceId 重建 span 树、查根 span 与服务拓扑;还可深入分析会话分组、工具调用参数与结果、跨服务关联及异常字段。

必要用法:需要运行中的 OpenSearch 集群并已写入 OTel trace 数据,且已安装 uv 以运行辅助脚本。可选配置 MCP 服务器:opensearch-mcp-server 提供直接 API 访问(含 PPL,支持 AOS/AOSS 的 SigV4 认证),ddg-search 用于检索 OpenSearch 文档;配置按本地基本认证、AOS、AOSS 分为不同环境变量变体。使用 PPL 作为主要查询语言,点号字段名需反引号引用,大索引上用 head N 限制结果。

限制与规则:遵循发现优先,不假设索引模式和字段名;未知 PPL 命令或语法必须查阅上游官方文档,不得猜测或臆造参数,也不得在未查文档前断言命令不存在;若集群端点可用,应通过 _plugins/_ppl 验证查询,返回 0 行可再用 _explain 确认,无端点则必须明确说明查询未经验证。具体索引字段与数据形态需实际探查,资料未提供固定 schema。