View a markdown version of this page

验证执行日志传输 - Amazon API Gateway
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

验证执行日志传输

创建日志传输后,请验证传输是否处于活动状态,以及执行日志是否到达目标。

要确认传输处于活动状态,请使用 describe-deliveries 命令:

aws logs describe-deliveries

然后,发送测试请求并检查您的目标:

  1. 向您的 REST API 发送测试请求。

    curl https://{rest-api-id}.execute-api.{region}.amazonaws.com/{stage}/{resource}
  2. 等待 1–2 分钟,让日志传播。

  3. 检查您的目标是否存在日志事件:

    • CloudWatch Logs:打开 CloudWatch Logs 控制台并导航到您的日志组。您应该会看到一个包含近期事件的日志流。

    • Amazon S3:打开 Amazon S3 控制台并导航到您的存储桶。查找路径前缀包含您的 REST API ID 的对象。

    • Firehose:在 Firehose 控制台中查看传输流指标,以确认数据正在流动。

问题排查

如果日志未到达目标,请检查以下各项:

  • 日志记录已启用:确认已在阶段上将 loggingLevel 设置为 ERROR 或 INFO。如果日志记录为 OFF,则无论传输配置如何,都不会生成任何日志。

  • 传输状态:使用 get-delivery CLI 命令来检查传输状态并确认其处于活动状态。

    aws logs get-delivery --id {delivery-id}
  • 权限:验证目标上的资源策略是否可让 Amazon CloudWatch Logs 向其写入数据。有关更多信息,请参阅《Amazon CloudWatch Logs 用户指南》中的从 Amazon 服务启用日志记录。