如何查询AWS X-Ray月度追踪数据统计指定API月调用次数

首先明确：X-Ray控制台最长6小时的检索限制只是控制台前端的交互限制，X-Ray服务本身默认留存30天的trace数据，完全覆盖你需要的1个月统计跨度，不需要提前做额外存储改造就能实现需求，具体可选方案如下：

方案1：直接调用X-Ray API批量统计（零额外改动，适合快速出结果） #

• 你当前采样率为100%，统计结果不需要做采样折算，数值完全准确
• 核心逻辑是分页调用X-Ray的GetTraceSummaries接口，指定上个月的起止Unix时间戳，用过滤表达式匹配http.request.url等于https://example.com/service1/api1的trace条目，累计符合条件的条目总数就是该接口的上月总调用次数
• 注意单次接口调用最多返回1000条trace摘要，需要通过返回的NextToken做分页遍历；如果上月调用量较大，可以把整月时间范围按小时切片拆分请求，避免单次请求超时或者返回数据量过大
• 不想写自定义脚本的话，直接用AWS CLI就可以做拉取统计，核心命令参考：

# 将<START_TIME>、<END_TIME>替换为上个月起止时间的Unix时间戳
aws xray get-trace-summaries --start-time <START_TIME> --end-time <END_TIME> \
--filter-expression 'http.request.url = "https://example.com/service1/api1"' \
--query 'length(TraceSummaries[])'

• 这个方案的短板是如果月度调用量在千万级以上，全量分页拉取的耗时会比较长，更适合百万级及以下调用量的场景。

方案2：X-Ray导出到S3 + Athena SQL查询（适合长期做全链路多维度统计） #

• 这是生产环境长期做跨月链路数据分析的标准方案，完全没有控制台的时间范围限制：
  • 先在X-Ray控制台开启trace自动导出到账号下的S3存储桶，导出格式选Parquet，压缩比高、查询成本低
  • 在Athena中创建指向该S3存储路径的外部表，直接写SQL筛选对应路径的请求、按时间分区过滤，秒级就能拿到上月调用量结果，后续要统计其他接口、错误率、延迟分位值都可以直接写SQL查询，不需要反复拉取全量trace
• 注意：该方案只能统计导出配置开启后新生成的trace数据，如果之前没开导出，要补统计已生成的上月历史数据，还是需要先用方案1完成统计，导出配置生效后，后续的跨月统计直接查Athena即可。

方案3：CloudWatch Contributor Insights预聚合（适合后续长期监控接口指标） #

• 如果后续需要长期监控这个接口的调用量、错误率等指标，可以直接在CloudWatch中为X-Ray trace配置Contributor Insights规则，自动按接口维度聚合生成调用指标，数据默认留存15个月，后续查任意时间范围的调用数都可以直接拉取聚合指标，不需要每次扫描全量trace数据。
• 该方案同样只对规则配置生效后生成的数据有效，历史数据统计还是要依赖前两种方案。

补充提示：如果后续调整了X-Ray采样率，以上方案统计出的trace数量需要按采样比例做折算，才能得到真实的接口总调用次数。

内容的提问来源于stack exchange，提问作者Akshay