SuperAPI AI 工具集

oodle-traces

通用与其它

查看项目

更新于 10-16 02:39

技能介绍

用途:让智能体按服务、时间、时长等条件检索 Oodle 链路追踪,按 ID 获取完整 trace,并运行 TraceQL 搜索与指标查询。

前置条件:brew install oodle-ai/oodle/oodle,然后 oodle configure。可用 oodle traces list --start -15m --end now -o json | jq 'length' 验证端点。

主要能力:oodle traces list 按 --service、--start、--end 及 --tags '{"span_status":"Error"}'、--min-duration、--operation 过滤;oodle traces get <trace-id> 获取单条 trace;oodle traces traceql search 与 traceql metrics 执行 TraceQL;traceql tags / tag-values 查询属性名与值。

使用方式:list 与 get 必须提供 --start 和 --end,支持 epoch、RFC 3339、now、-1h 等相对时长。TraceQL 查询用单引号包裹。示例:oodle traces list --service api --tags '{"span_status":"Error"}' --start -1h --end now -o json;oodle traces traceql metrics '{ status = error } | rate() by (resource.service.name)' --start -6h --step 5m。

限制:生产环境不要无 --service 运行 list;list 时间窗建议不超过 24 小时;TraceQL 尚不支持标量过滤、{ A } && { B }、结构操作符、parent./link. 作用域、rootName/traceDuration 及裸存在写法,需按替代方式改写。监控使用 PromQL 而非 TraceQL。

适用场景:排查错误与慢请求、按服务或路由统计错误率与延迟分位数、下钻单条 trace。缺失信息:具体收费、平台支持范围暂未提供。