에 대한 지표 활성화 AWS SDK for Java - AWS SDK for Java 1.x

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

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

에 대한 지표 활성화 AWS SDK for Java

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

  • 액세스 시 애플리케이션 성능 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 에서 SDK 사용할 수 있는 최신 버전의 로 바꿉니다.

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 요청/응답 지연 시간, 요청 수, 예외 및 재시도와 같은 영역을 다룹니다.

    RequestMetric 131111
AWS 서비스 지표
  • S3 업로드 및 다운로드의 처리량 및 바이트 수와 같은 AWS 서비스특정 데이터를 포함합니다.

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

    MachineMetric 131111

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

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

추가 정보