AWS SDK for Java 1.x는 2024년 7월 31일부터 유지 관리 모드로 전환되었으며 2025년 12월 31일에 지원 종료
AWS SDK for Java에 대한 지표 활성화
AWS SDK for Java는 다음을 측정하는 Amazon CloudWatch
-
AWS 액세스 시 애플리케이션의 성능
-
AWS에 사용되는 JVM의 성능
-
힙 메모리, 스레드 수 및 열었던 파일 설명자 등 실행 시간 환경 세부 정보
SDK 지표 생성을 활성화하는 방법
SDK가 지표를 CloudWatch로 전송할 수 있도록 하려면 다음과 같은 Maven 종속성을 추가해야 합니다.
<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
AWS SDK for Java 지표는 기본적으로 비활성화되어 있습니다. 로컬 개발 환경에서 활성화하려면 JVM을 시작할 때 AWS 보안 자격 증명 파일을 가리키는 시스템 속성을 포함합니다. 예:
-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties
SDK에서 향후 분석을 위해 수집된 데이터 포인트를 CloudWatch로 업로드할 수 있도록 자격 증명 파일에 대한 경로를 지정해야 합니다.
참고
Amazon EC2 인스턴스 메타데이터 서비스를 사용하여 Amazon EC2 인스턴스에서 AWS에 액세스하려는 경우에는 자격 증명 파일을 지정할 필요가 없습니다. 이 경우에는 다음 항목만 지정하면 됩니다.
-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 SDK for Java로부터 AWS에 대한 서비스 요청이 있을 때마다 지표 데이터 포인트가 생성되고, 통계 요약을 위해 대기열에 추가되며, 거의 1분에 한 번씩 CloudWatch에 비동기적으로 업로드됩니다. 지표는 업로드되고 나면 AWS Management 콘솔
사용 가능한 지표 유형
기본 지표 세트는 세 가지 주요 범주로 나눠집니다.
- AWS 요청 지표
-
-
HTTP 요청/응답 지연 시간, 요청 수, 예외 및 재시도 등을 포함합니다.
-
- AWS 서비스 지표
-
-
S3 업로드 및 다운로드에 대한 처리량과 바이트 수 같은 AWS 서비스별 데이터를 포함합니다.
-
- 머신 지표
-
-
힙 메모리, 스레드 수 및 열린 파일 설명자 등 실행 시간 환경을 포함합니다.
머신 지표를 제외하려면
excludeMachineMetrics를 시스템 속성에 추가합니다.-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,excludeMachineMetrics
-
추가 정보
-
미리 정의된 핵심 지표 유형의 전체 목록은 amazonaws/metrics package summary를 참조하십시오.
-
AWS SDK for Java를 사용하는 CloudWatch 예제의 AWS SDK for Java를 사용하여 CloudWatch로 작업하는 방법에 대해 알아보세요.
-
AWS SDK for Java를 튜닝하여 복원력 향상
블로그 게시물에서 성능 튜닝에 대해 자세히 알아보세요.