AWS SDK for Java 1.x는 2025년 12월 31일에 end-of-support되었습니다. 새로운 기능, 가용성 개선 및 보안 업데이트를 계속 받으려면 [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html)로 마이그레이션하는 것이 좋습니다.

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

# 에 대한 지표 활성화 AWS SDK for Java
<a name="generating-sdk-metrics"></a>

는 다음을 측정하는 [Amazon CloudWatch](https://aws.amazon.com/cloudwatch/)를 사용하여 시각화 및 모니터링을 위한 지표를 생성할 AWS SDK for Java 수 있습니다.
+ 에 액세스할 때 애플리케이션의 성능 AWS 
+ 와 함께 사용할 때 JVMs의 성능 AWS 
+ 힙 메모리, 스레드 수 및 열었던 파일 설명자 등 실행 시간 환경 세부 정보

## SDK 지표 생성을 활성화하는 방법
<a name="how-to-enable-sdk-java-metric-generation"></a>

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>
```

 \$1버전 번호를 [Maven Central](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom)에서 사용할 수 있는 최신 버전의 SDK로 교체하세요.

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 에서 AWS SDK for Java에 대한 서비스 요청이 있을 때마다 지표 데이터 포인트가 생성되고 통계 요약을 위해 대기열에 추가되며 약 1분마다 CloudWatch에 비동기적으로 업로드됩니다. 지표는 업로드되고 나면 [AWS Management Console](https://console.aws.amazon.com/console/home)을 사용하여 시각화할 수 있으며, 메모리 누출, 파일 설명자 누출 등 잠재적인 문제에 대한 경보를 설정할 수 있습니다.

## 사용 가능한 지표 유형
<a name="available-metric-types"></a>

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

 AWS 지표 요청  
+ HTTP 요청/응답 지연 시간, 요청 수, 예외 및 재시도 등을 포함합니다.  
![\[RequestMetric 131111\]](http://docs.aws.amazon.com/ko_kr/sdk-for-java/v1/developer-guide/images/RequestMetric-131111.png)

 AWS 서비스 지표  
+ S3 업로드 및 다운로드의 처리량 및 바이트 수와 같은 AWS 서비스특정 데이터를 포함합니다.  
![\[ServiceMetric 131111\]](http://docs.aws.amazon.com/ko_kr/sdk-for-java/v1/developer-guide/images/ServiceMetric-131111.png)

머신 지표  
+ 힙 메모리, 스레드 수 및 열린 파일 설명자 등 실행 시간 환경을 포함합니다.  
![\[MachineMetric 131111\]](http://docs.aws.amazon.com/ko_kr/sdk-for-java/v1/developer-guide/images/MachineMetric-131111.png)

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

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

## 추가 정보
<a name="more-information"></a>
+ 미리 정의된 핵심 지표 유형의 전체 목록은 [amazonaws/metrics package summary](https://docs.aws.amazon.com/sdk-for-java/v1/reference/com/amazonaws/metrics/package-summary.html)를 참조하십시오.
+ 를 사용한 CloudWatch 예제 AWS SDK for Java 에서 [를 사용한 CloudWatch AWS SDK for Java](examples-cloudwatch.md)작업에 대해 알아봅니다.
+ [복원력 개선을 AWS SDK for Java 위한 조정 블로그 게시물에서 성능 튜닝에](https://aws.amazon.com/blogs/developer/tuning-the-aws-sdk-for-java-to-improve-resiliency) 대해 자세히 알아보세요.