服务客户指标

借助AWS SDK for Java 2.x，您可以从应用程序中的服务客户端收集指标，然后将这些指标发布（输出）到亚马逊CloudWatch。

这些表列出了您可以收集的指标以及任何 HTTP 客户端使用要求。

有关启用和配置 SDK 指标的更多信息，请参阅启用 SDK 指标。

表中使用的术语意味着：

• Apache：基于 Apache 的 HTTP 客户端 () ApacheHttpClient

• Netty：基于 Netty 的 HTTP 客户端 () NettyNioAsyncHttpClient

• CRT：AWS基于 CRT 的 HTTP 客户端 () AwsCrtAsyncHttpClient

• 任意：指标数据的收集不依赖于 HTTP 客户端；这包括使用基于 URLConnection 的 HTTP 客户端 () UrlConnectionHttpClient

每次请求收集的指标

指标名称	描述	类型	需要 HTTP 客户端
ApiCallDuration	完成请求所花费的总时间（包括所有重试）	Duration	任何
ApiCallSuccessful	如果 API 调用成功则为真；如果不成功则为假	布尔值	任何
CredentialsFetchDuration	获取请求的AWS签名证书所花费的时间	Duration	任何
MarshallingDuration	整理请求所花费的时间	Duration	任何
OperationName	向其发出请求的 AWS API 的名称	字符串	任何
RetryCount	SDK 重试 API 调用的次数	整数	任何
ServiceId	API 请求AWS 服务所针对的服务 ID	字符串	任何
TokenFetchDuration	为请求获取令牌签名证书所花费的时间	Duration	任何

为每次请求尝试收集的指标

您的应用程序发出的每个 API 调用可能需要多次尝试才能以成功或失败的形式响应。每次尝试都会收集这些指标。

指标名称	描述	类型	需要 HTTP 客户端
AvailableConcurrency	HTTP 客户端无需建立其他连接即可支持的剩余并发请求数	整数	Apache、Netty、CRT
AwsExtendedRequestId	服务请求的扩展请求 ID	字符串	任何
AwsRequestId	服务请求的请求 ID	字符串	任何
BackoffDelayDuration	SDK 在尝试此 API 调用之前等待的时间	Duration	任何
ConcurrencyAcquireDuration	从连接池获取频道所花费的时间	Duration	Apache、Netty、CRT
HttpClientName	用于请求的 HTTP 的名称	字符串	Apache、Netty、CRT
HttpStatusCode	HTTP 响应返回的状态码	整数	任何
LeasedConcurrency	HTTP 客户端当前正在执行的请求数	整数	Apache、Netty、CRT
LocalStreamWindowSize	执行此请求的流的本地 HTTP/2 窗口大小（以字节为单位）	整数	内蒂
MarshallingDuration	将 SDK 请求编译为 HTTP 请求所花费的时间	Duration	任何
MaxConcurrency	HTTP 客户端支持的最大并发请求数	整数	Apache、Netty、CRT
PendingConcurrencyAcquires	等待另一个 TCP 连接或连接池中出现新数据流时被阻塞的请求数量	整数	Apache、Netty、CRT
RemoteStreamWindowSize	执行此请求的流的远程 HTTP/2 窗口大小（以字节为单位）	整数	内蒂
ServiceCallDuration	连接到服务、发送请求以及从响应中接收 HTTP 状态码和标头所花费的时间	Duration	任何
SigningDuration	签署 HTTP 请求所花费的时间	Duration	任何
UnmarshallingDuration	解除对 SDK 响应的 HTTP 响应所花费的时间	Duration	任何