为启用指标 Amazon SDK for Java - Amazon SDK for Java 1.x
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

我们宣布了即将推出 end-of-support 的 Amazon SDK for Java (v1)。建议您迁移到 Amazon SDK for Java v2。有关日期、其他详细信息以及如何迁移的信息,请参阅链接的公告。

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

为启用指标 Amazon SDK for Java

Amazon SDK for Java 可以生成用于通过 Amazon 进行可视化和监控的指标,这些指标 CloudWatch可以衡量:

  • 您的应用程序在访问时的性能 Amazon

  • 与一起使用时 JVM 的性能 Amazon

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

如何启用 Java SDK 指标生成

您需要添加以下 Maven 依赖项才能让 SDK 向其发送指标。 CloudWatch

<dependencyManagement> <dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk-bom</artifactId> <version>1.12.490*</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk-cloudwatchmetrics</artifactId> <scope>provided</scope> </dependency> <!-- Other SDK dependencies. --> </dependencies>

*将版本号替换为 Maven Central 上可用的最新版 SDK。

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

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

您需要指定证书文件的路径,以便 SDK 可以将收集到的数据点上传到以 CloudWatch 供日后分析。

注意

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

-Dcom.amazonaws.sdk.enableDefaultMetrics

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

-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,cloudwatchRegion={region_api_default}

启用该功能后,每次有 Amazon 来自的服务请求时,都会生成指标数据点 Amazon SDK for Java,排队等候统计摘要,然后异步上传到 CloudWatch 大约每分钟一次。指标一旦上传,您就可以使用 Amazon Web Services Management Console将其可视化,并设置潜在问题的警报,如内存泄露、文件描述符泄露等等。

可用指标类型

默认指标组分为三大类:

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

    
                           RequestMetric 131111
Amazon Web Service 指标
  • 包括 Amazon Web Service特定数据,例如 S3 上传和下载的吞吐量和字节数。

    
                           ServiceMetric 131111
机器指标
  • 涵盖运行时环境,包括堆内存、线程数和打开的文件描述符。

    
                           MachineMetric 131111

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

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

更多信息