Amazon API Gateway 维度和指标 - Amazon API Gateway
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Amazon API Gateway 维度和指标

API Gateway 发送给亚马逊的指标和维度 CloudWatch 如下所示。有关更多信息,请参阅使用 Amazon CloudWatch 指标监控 REST API 执行

API Gateway 指标

Amazon API Gateway CloudWatch 每分钟发送一次指标数据。

AWS/ApiGateway 命名空间包括以下指标。

指标 说明

4XXError

在给定期间捕获的客户端错误数。

API Gateway 将修改后的网关响应状态代码计为 4xxError 错误。

Sum 统计数据表示此指标,即给定期间内 4XXError 错误的总计数。Average 统计数据表示 4XXError 错误率,即 4XXError 错误的总计数除以该期间中的请求总数。分母对应于 Count 指标 (见下)。

Unit: Count

5XXError

在给定期间捕获的服务器端错误数。

Sum 统计数据表示此指标,即给定期间内 5XXError 错误的总计数。Average 统计数据表示 5XXError 错误率,即 5XXError 错误的总计数除以该期间中的请求总数。分母对应于 Count 指标 (见下)。

Unit: Count

CacheHitCount

在给定期间内从 API 缓存中提供的请求数。

Sum 统计数据表示此指标,即给定期间内缓存命中的总计数。Average 统计数据表示缓存命中率,即缓存命中的总计数除以该期间中的请求总数。分母对应于 Count 指标 (见下)。

Unit: Count

CacheMissCount

在启用 API 缓存时,在给定期间内由后端所服务的请求的数量。

Sum 统计数据表示此指标,即指定期间内缓存未命中的总计数。Average 统计数据表示缓存未命中率,即缓存未命中的总计数除以该期间中的请求总数。分母对应于 Count 指标 (见下)。

Unit: Count

Count

给定期间内的 API 请求总数。

SampleCount 统计数据表示此指标。

Unit: Count

IntegrationLatency

从 API Gateway 将请求中继到后端到其从后端收到响应所经过的时间。

Unit: Millisecond

Latency

从 API Gateway 从客户端收到请求到其将响应返回给客户端所经过的时间。延迟包括集成延迟和其他 API Gateway 开销。

Unit: Millisecond

指标的维度

您可以使用下表中的维度筛选 API Gateway 指标。

注意

在向发送指标之前,API Gateway 会从ApiName维度中删除非 ASCII 字符。 CloudWatch如果 APIName 不包含任何 ASCII 字符,则 API ID 将用作 ApiName。

维度 说明

ApiName

针对具有指定 API 名称的 REST API 筛选 API Gateway 指标。

ApiName, Method, Resource, Stage

针对具有指定 API 名称、阶段、资源和方法的 API 方法筛选 API Gateway 指标。

除非您明确启用详细指标,否则 API Gateway 不会发送这些 CloudWatch 指标。在控制台中,选择一个阶段,然后对于日志和跟踪,选择编辑。选择详细指标,然后选择保存更改。或者,您可以调用 update- Amazon CLI stag e 命令将属性更新为。metricsEnabled true

启用这些指标会对您的账户额外计费。有关定价信息,请参阅 Amazon CloudWatch 定价

ApiName, Stage

针对具有指定 API 名称和阶段的 API 方法筛选 API Gateway 指标。