에 대한 메트릭을 활성화합니다. AWS SDK for Java - AWS SDK for Java 1.x

AWS SDK for Java 1.x는 2024년 7월 31일부터 유지 관리 모드로 전환되었으며 2025년 12월 end-of-support31일에 출시될 예정입니다. 새 기능, 가용성 개선 사항 및 AWS SDK for Java 2.x보안 업데이트를 계속 받으려면 로 마이그레이션하는 것이 좋습니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

에 대한 메트릭을 활성화합니다. AWS SDK for Java

Amazon의 시각화 및 모니터링을 위한 지표를 생성하여 다음을 CloudWatch 측정할 AWS SDK for Java 수 있습니다.

  • 액세스 시 애플리케이션의 성능 AWS

  • 와 함께 사용할 JVMs 때의 성능 AWS

  • 힙 메모리, 스레드 수 및 열었던 파일 설명자 등 실행 시간 환경 세부 정보

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 사용할 수 있는 최신 버전으로 바꾸십시오.

AWS SDK for Java 메트릭은 기본적으로 비활성화됩니다. 로컬 개발 환경에서 사용하도록 설정하려면 를 시작할 때 AWS 보안 자격 증명 파일을 가리키는 시스템 속성을 포함하십시오. JVM 예:

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

수집된 데이터포인트를 나중에 분석할 수 있도록 SDK 업로드할 수 있도록 자격 증명 파일의 경로를 지정해야 합니다 CloudWatch .

참고

인스턴스 메타데이터 서비스를 사용하여 AWS Amazon EC2 인스턴스에서 액세스하는 경우 자격 증명 파일을 지정하지 않아도 됩니다. Amazon EC2 이 경우에는 다음 항목만 지정하면 됩니다.

-Dcom.amazonaws.sdk.enableDefaultMetrics

에서 캡처한 모든 AWS SDK for Java 지표는 AWSSDK/Java 네임스페이스에 있으며 CloudWatch 기본 리전 (us-east-1) 에 업로드됩니다. 리전을 변경하려면 시스템 속성에서 cloudwatchRegion 속성을 사용하여 지정합니다. 예를 들어 CloudWatch 지역을 us-east-1로 설정하려면 다음을 사용하십시오.

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

이 기능을 활성화하면 AWS 에서 서비스를 요청할 때마다 지표 데이터 포인트가 생성되고 통계 요약 대기열에 추가되며 약 1분에 한 번씩 비동기적으로 업로드됩니다. AWS SDK for Java CloudWatch 지표는 업로드되고 나면 AWS Management Console을 사용하여 시각화할 수 있으며, 메모리 누출, 파일 설명자 누출 등 잠재적인 문제에 대한 경보를 설정할 수 있습니다.

사용 가능한 지표 유형

기본 지표 세트는 세 가지 주요 범주로 나눠집니다.

AWS 요청 지표
  • HTTP요청/응답 지연 시간, 요청 수, 예외 및 재시도와 같은 영역을 다룹니다.

    RequestMetric 131111
AWS 서비스 메트릭스
  • S3 업로드 및 다운로드의 처리량 및 바이트 수와 같은 AWS 서비스특정 데이터를 포함하십시오.

    ServiceMetric 131111
머신 지표
  • 힙 메모리, 스레드 수 및 열린 파일 설명자 등 실행 시간 환경을 포함합니다.

    MachineMetric 131111

    머신 지표를 제외하려면 excludeMachineMetrics를 시스템 속성에 추가합니다.

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

추가 정보