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