API Gateway超时日志含X-Ray Trace ID，控制台查询提示未找到数据

• X-Ray Trace留存超期：X-Ray默认的trace数据留存窗口为30天，你提到的异常504请求触发于2021-02-12，可正常查询的200请求触发于2021-02-17，若查询X-Ray的时间点距离02-12的请求超过留存阈值，即便CloudWatch日志中永久留存了Trace ID字符串，X-Ray侧存储的原始trace segment也会被自动清理，触发「未找到数据」提示。
• 超时中断导致Trace未完成上报：API Gateway在接收请求初始阶段就会生成Trace Root ID并写入访问日志，若请求在构造、上报自身X-Ray segment的流程中触发504超时（比如后端集成超时、API Gateway执行流异常中断），就会出现“日志打印了Trace ID，但没有实际segment数据上报到X-Ray服务”的情况——此时的Trace ID仅是请求阶段生成的标识，没有对应的实体trace数据存储。
• 查询时间范围不匹配：X-Ray控制台默认的查询窗口为最近1/3/24小时的固定区间，若搜索Trace ID时没有手动将时间范围调整到2021-02-12的请求触发时段，哪怕trace数据仍在留存期内，也会返回无结果。
• 采样规则拦截超时请求：API Gateway的X-Ray采样存在固定配额逻辑（默认每10秒窗口内至少采样1个请求、最多采样10%的请求），若504超时请求发生时正好处在采样窗口的配额耗尽时段，或是采样规则明确排除了5xx状态码的请求，就会被直接判定为不满足上报条件——此时API Gateway仅会在访问日志中生成Trace ID占位标识，不会实际构造、上报trace segment。

• 校准X-Ray控制台的查询时间范围，将查询区间手动调整到目标异常请求的精确触发时间前后各1小时，重新搜索对应Trace ID，排除默认查询窗口过窄导致的无结果问题。
• 核对API Gateway的X-Ray采样规则配置：确认采样规则是否排除了5xx状态码请求、是否将采样率设置过低，针对网关类超时请求需单独配置规则，将504、502等错误码请求纳入采样上报范围，避免超时类请求被采样配额拦截。
• 检查X-Ray的数据留存配置：确认当前服务的trace留存周期设置，若留存周期短于回溯需求的时间跨度，可在X-Ray控制台调整留存时长（最高支持180天），避免历史trace被自动清理。
• 验证API Gateway阶段的Tracing开关状态：确认目标API的阶段配置下，Enable X-Ray Tracing开关在异常请求发生的时间点处于开启状态，若开关在对应时段处于关闭状态，即便后续2021-02-17的请求因为开关开启能正常上报trace，历史时段的请求也不会有对应的上报记录。
• 排查API Gateway到X-Ray服务的网络连通性：若API Gateway部署在VPC内，需确认是否配置了指向X-Ray服务的VPC端点，若临时网络抖动导致segment上报通道中断，也会出现日志记录Trace ID但实际未推送成功的情况。

你提供的X-Ray控制台截图可用于交叉验证当前查询的时间范围、采样统计配置是否符合预期。

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