SuperAPI AI 工具集

aliyun-arms-query

部署与运维

查看项目

更新于 10-15 18:46

技能介绍

用途:该技能用于在阿里云 ARMS 中查询分布式链路(Trace)与应用性能指标(Metrics),适合排查慢调用、错误链路与聚合性能分析。

主要能力:按服务名、操作名、耗时、标签、错误状态、PID 等条件分页检索链路;按 TraceID 获取完整 span 调用树(支持分页);按 TraceID、RpcID、PID 获取方法级调用栈;按 PID、指标名、维度与度量查询预定义指标表并支持排序;列出已接入链路的应用以获取 PID。常用指标包括 appstat.incall、appstat.outcall、appstat.sql、appstat.exception、appstat.host,常用度量为 rt、count、error。

使用方式:先安装 SDK:python3 -m venv .venv、. .venv/bin/activate、python -m pip install -U alibabacloud_arms20190808 alibabacloud_tea_openapi。配置环境变量 ALIBABACLOUD_ACCESS_KEY_ID、ALIBABACLOUD_ACCESS_KEY_SECRET、ARMS_REGION_ID(如 cn-hangzhou)。凭据也可使用 ~/.alibabacloud/credentials 的 default profile。脚本示例:search_traces.py --service-name my-app --last-minutes 15;get_trace_detail.py --trace-id <id>;query_metrics.py --metric appstat.incall --pid "xxx@cn-hangzhou" --last-minutes 30;list_trace_apps.py;get_stack.py --trace-id <id> --rpc-id 0.1 --pid "xxx@cn-hangzhou"。时间范围使用 epoch 毫秒,PID 格式为 xxx@regionId,可通过 ListTraceApps 获取。

限制:需要有效的阿里云凭据与已接入 ARMS 的应用数据;指标查询依赖预定义指标表与 PID;文档未提及收费、价格及配额信息,暂未提供。