Amazon API Gateway 维度和指标 - Amazon API Gateway
API Gateway 指标指标的维度

Amazon API Gateway 维度和指标

下面列出 API Gateway 发送给 Amazon 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 指标。

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

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

ApiName, Stage

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