如何通过AWS Xray Trace ID查询CloudWatch日志？

核心配置前提 #

先确保各服务已完成X-Ray与CloudWatch的基础关联配置：

• Lambda角色需附加AWSXRayDaemonWriteAccess权限，同时在Lambda控制台将X-Ray追踪模式设为Active。
• API Gateway控制台开启X-Ray追踪（路径：设置>X-Ray）。
• EventBridge规则触发Lambda时，需在规则配置中启用X-Ray追踪；DynamoDB流触发Lambda时，Lambda的X-Ray会自动追踪调用链路。

直接通过Trace ID查询CloudWatch日志的方法 #

1. CloudWatch Insights 精准查询 #

使用CloudWatch Insights的SQL语句过滤包含目标Trace ID的日志，可根据日志格式调整过滤规则：

fields @timestamp, @message
| filter @message like /"traceId": "YOUR_TRACE_ID_HERE"/ or @message like /X-Ray Trace ID: YOUR_TRACE_ID_HERE/
| sort @timestamp desc
| limit 100

注：Lambda默认日志开头会携带X-Ray Trace ID: 1-xxxx-xxxx格式的标识，自定义日志需确保注入Trace ID，才能被该语句匹配。

2. Lambda代码注入Trace ID到日志 #

在TypeScript代码中通过X-Ray SDK获取当前Trace ID，将其作为字段嵌入自定义日志输出：

import AWSXRay from 'aws-xray-sdk';
import { createLogger } from 'winston'; // 以winston为例，其他日志库同理

const logger = createLogger({ /* 日志配置 */ });

const getCurrentTraceId = () => {
  const segment = AWSXRay.getSegment();
  return segment ? segment.trace_id : 'unknown-trace-id';
};

// 输出日志时携带Trace ID
logger.info('处理用户请求完成', { traceId: getCurrentTraceId(), userId: '123' });

通过X-Ray控制台直接跳转至CloudWatch日志 #

在X-Ray控制台的追踪详情页，每个服务节点（如Lambda、API Gateway）的卡片中会显示查看日志入口，点击可直接跳转至对应CloudWatch日志组与日志流。该功能依赖基础配置的正确性，若未显示需检查服务的X-Ray追踪是否完全开启。

针对EventBridge、DynamoDB的日志关联优化 #

• EventBridge：开启规则的X-Ray追踪后，EventBridge的调用链路会被X-Ray记录，其自身日志可在CloudWatch日志组/aws/events/[你的规则名称]中查询，通过Trace ID过滤即可定位对应请求日志。
• DynamoDB：流触发Lambda时，Lambda日志会自动携带关联的Trace ID；若为Lambda直接调用DynamoDB API，X-Ray SDK会生成DynamoDB的Segment，对应的操作日志可在Lambda日志中通过Trace ID找到。

自定义Segment关联日志组信息 #

若需通过X-Ray的Segments/Docs直接获取日志组信息，可在代码中手动为Segment添加注释：

const segment = AWSXRay.getSegment();
if (segment) {
  segment.addAnnotation('logGroup', '/aws/lambda/[你的Lambda函数名]');
  segment.addAnnotation('logStream', '[目标日志流名称]');
}

添加后，在X-Ray控制台的Segment详情中可查看这些注释信息，快速定位到对应的CloudWatch日志位置。

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