为 AWS SDK for Java 启用指标 - 适用于 Java 的 AWS 开发工具包
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

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

为 AWS SDK for Java 启用指标

可以为 AWS SDK for Java 的可视化和监控生成衡量以下各项的指标:CloudWatch

  • 访问 AWS 时应用程序的性能

  • 与 AWS 结合使用时的 JVMs 性能

  • 运行时环境详细信息,例如堆内存、线程数和已打开的文件描述符

注意

AWS SDK Metrics for Enterprise Support 是收集应用程序指标的另一种选择。SDK Metrics 是一项 AWS 服务,可向 Amazon CloudWatch 发布数据并使您能够与 AWS Support 共享指标数据以便进行故障排除。请参阅为企业支持启用 AWS 开发工具包指标,了解如何为您的应用程序启用 SDK Metrics 服务。

如何启用 AWS SDK for Java 指标生成

AWS SDK for Java指标默认处于禁用状态。要为您的本地开发环境启用此功能,请在启动 JVM 时包括指向您的 AWS 安全凭证文件的系统属性。例如:

-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties

您需要指定凭证文件的路径,以便开发工具包将收集到的数据点上传到 CloudWatch 供日后分析。

注意

如果您要通过 Amazon EC2 实例元数据服务从 Amazon EC2 实例访问 AWS 服务,则无需指定凭证文件。在这种情况下,您只需要指定以下各项:

-Dcom.amazonaws.sdk.enableDefaultMetrics

适用于 Java 的开发工具包捕获到的所有指标都位于命名空间 AWSSDK/Java 下,并将上传到 CloudWatch 默认区域 (us-east-1)。要更改该区域,请使用系统属性中的 cloudwatchRegion 属性来指定它。例如,要将 CloudWatch 区域设为 us-west-2,请使用:

-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,cloudwatchRegion=us-west-2

启用该功能后,每次AWS SDK for Java向 AWS 发出服务请求时,都将生成指标数据点,按统计摘要排队,并大约每分钟向 CloudWatch 异步上传一次。指标一旦上传,您就可以使用 AWS 管理控制台将其可视化,并设置潜在问题的警报,如内存泄露、文件描述符泄露等等。

可用指标类型

默认指标组分为三大类:

AWS 请求指标

涵盖诸如 HTTP 请求/响应的延迟、请求数量、异常和重试等领域。

AWS 服务指标

包括特定于 AWS 服务的数据,如 S3 上传和下载的吞吐量和字节数。

机器指标

涵盖运行时环境,包括堆内存、线程数和打开的文件描述符。

如果您想要排除机器指标,请在系统属性中添加 excludeMachineMetrics

-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,excludeMachineMetrics

更多信息