AWS API Gateway详细指标不显示具体资源路径如何解决？

核心原因 #

当API Gateway使用**通配符资源（/{any+}）**做全局路径匹配时，即便开启了详细指标，CloudWatch也只会记录这个通配符路径，不会解析实际请求的具体路径。

具体解决步骤 #

• 替换通配符为明确路径定义：
  不要用/{any+}这类全局匹配资源，逐个定义具体API路径（比如/users、/users/{id}），并为每个路径绑定对应方法（GET/PUT等）。API Gateway会自动为每个明确路径生成独立的指标维度。
• 验证指标维度配置：
  开启详细指标后，确认API Gateway的指标维度包含ApiName、Resource和Method。在CloudWatch查看指标时，需同时选择这三个维度来拆分数据。
• 保留通配符时的自定义指标方案：
  如果必须用通配符路由（比如后端转发场景），可以通过Lambda代理集成在后端处理并自定义上报指标：
  1. 在Lambda函数中从event.path和event.httpMethod获取实际请求的路径与方法。
  2. 用AWS SDK的cloudwatch.putMetricData接口，上报带Path和Method维度的自定义延迟指标。
• 确认阶段配置生效：
  确保开启详细指标的设置应用到了当前使用的API阶段（比如prod阶段），每个阶段的指标配置是独立的。

注意事项 #

• 明确路径的数量会影响CloudWatch指标数量，过多路径可能增加监控成本，需要平衡粒度与成本。
• 若使用VPC链接或私有集成，同样要保证路径定义为明确值，而非通配符。

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