如何通过AWS CDK实现API Gateway原始请求日志至CloudWatch？

1. 是否可以通过CDK将API Gateway的原始请求日志记录到CloudWatch？ #

可以实现。你可以通过扩展现有accessLogFormat的自定义字段，捕获原始请求的相关内容（比如请求体、请求头等），再通过LogGroupLogDestination输出到CloudWatch日志组。

示例代码修改如下：

const api = new aws_apigateway.RestApi(this, 'kartal', {
    restApiName: "kartal",
    deployOptions: {
        stageName: process.env.ENVIRONMENT,
        loggingLevel: aws_apigateway.MethodLoggingLevel.INFO,
        metricsEnabled: true,
        // 开启数据追踪，允许记录请求/响应payload
        dataTraceEnabled: true,
        accessLogFormat: aws_apigateway.AccessLogFormat.custom(JSON.stringify({
            requestId: aws_apigateway.AccessLogField.contextRequestId(),
            ip: aws_apigateway.AccessLogField.contextIdentitySourceIp(),
            requestTime: aws_apigateway.AccessLogField.contextRequestTime(),
            resourcePath: aws_apigateway.AccessLogField.contextResourcePath(),
            method: aws_apigateway.AccessLogField.contextHttpMethod(),
            // 捕获原始请求体
            requestBody: aws_apigateway.AccessLogField.contextRequest(),
            // 捕获指定请求头，比如Content-Type
            contentTypeHeader: aws_apigateway.AccessLogField.contextRequestHeader('Content-Type'),
            // 捕获所有请求头
            allRequestHeaders: aws_apigateway.AccessLogField.contextRequestHeaders(),
            error: aws_apigateway.AccessLogField.contextErrorMessage(),
            validationError: aws_apigateway.AccessLogField.contextErrorValidationErrorString(),
            status: aws_apigateway.AccessLogField.contextStatus()
         })),
        accessLogDestination: new aws_apigateway.LogGroupLogDestination(apigwLogGroup)
    },
})

2. 是否可以通过CDK启用「完整请求与响应日志」选项？ #

控制台中的「完整请求与响应日志」是预设的日志格式集合，CDK没有直接对应的开关，但可以通过自定义日志格式+开启数据追踪来实现完全相同的效果：

1. 在deployOptions中设置dataTraceEnabled: true，该参数控制是否允许记录请求和响应的payload内容；
2. 在accessLogFormat中添加完整的日志字段，包括请求体、响应体、所有请求/响应头、错误详情等，模拟控制台预设的完整日志内容。

比如要记录响应体，可以添加：

responseBody: aws_apigateway.AccessLogField.contextResponse()

3. 若以上两种方式均不可行，该如何记录API Gateway的原始请求？ #

可以采用以下两种方案：

• Lambda代理集成：在API Gateway和后端服务之间添加Lambda代理，Lambda会接收完整的请求上下文（包含body、headers、query参数、路径参数等），你可以在Lambda代码中直接将这些内容写入CloudWatch Logs，或者存储到S3、DynamoDB等服务；
• X-Ray追踪：开启API Gateway的X-Ray集成（在CDK中通过xrayEnabled: true配置），X-Ray会自动记录请求的详细元数据和payload内容，你可以在X-Ray控制台查看追踪数据，也可以通过X-Ray API导出日志进行分析。

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