SuperAPI AI 工具集

find-traces

部署与运维

查看项目

更新于 10-16 05:00

技能介绍

用途:该技能用于分析 Axiom 中的 OpenTelemetry 分布式追踪,帮助定位错误、延迟问题和根因。适用于调查某个 trace ID、按条件(错误、延迟、服务)查找追踪,或调试链路问题。

主要能力:先通过 axiom dataset list -f json 发现包含追踪数据的数据集(常命名含 traces、spans 或 otel-*),再用 axiom query "['<trace-dataset>'] | getschema" --start-time -1h 核对字段。支持按 trace ID 取回完整追踪、查找错误追踪、查找慢追踪(如 duration >= 1000000000 对应 1 秒)、按服务查找追踪、列出追踪中的错误 span,以及关键路径分析。

使用方式:均通过 axiom query 命令加 APL 查询完成,常用 --start-time -1h -f json 参数。OTel 字段中 trace_id、span_id、parent_span_id、name、duration、kind、error 可不加括号,['service.name']、['status.code']、['status.message']、['scope.name'] 需加括号。duration 单位为纳秒,可用 duration / 1000000.0 转为毫秒。自定义属性存于 attributes.custom,聚合时需显式 tostring 转换。

可选能力:当仓库与服务匹配时,可将追踪数据与源码关联,从 scope.name 提取包路径并映射到本地代码,或按 operation name 搜索处理函数。代码不可用或不匹配时,仅做追踪分析即可。

输出:分析后给出追踪摘要、事件序列、错误分析、根因、可选的代码位置及建议操作。

限制:不适合指标分析(追踪用于请求流,聚合性能数据应使用日志/指标技能);仅适用于 OpenTelemetry 字段约定;若已有查询可直接执行;持续性追踪告警应使用 Axiom Monitors;APL 语法可参考 axiom-apl 技能。