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

# 에서 SDK 지표 게시 AWS SDK for Java 2.x
<a name="metrics"></a>

를 사용하면 애플리케이션의 서비스 클라이언트 및 요청에 대한 지표를 수집하고 Amazon CloudWatch Logs의 출력을 분석한 다음 조치를 취할 AWS SDK for Java 2.x 수 있습니다.

기본적으로 SDK에서 지표 수집은 비활성화되어 있습니다. 이 항목은 활성화하고 구성하는 데 도움이 됩니다.

## SDK 지표 사용 시작하기
<a name="getting-started-with-metrics"></a>

애플리케이션에서 지표 수집을 사용하려면 사용 사례에 따라 `[MetricPublisher](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/metrics/MetricPublisher.html)` 인터페이스의 적절한 구현을 선택하고 자세한 설정 안내를 따릅니다.

**장기 실행 애플리케이션의 경우:**
+ `[CloudWatchMetricPublisher](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/metrics/publishers/cloudwatch/CloudWatchMetricPublisher.html)` 사용
+ 전체 설정 안내, 코드 예제 및 구성 옵션은 [장기 실행 애플리케이션의 SDK 지표 게시](metric-pub-impl-cwmp.md)를 참조하세요.

** AWS Lambda 함수의 경우:**
+ `[EmfMetricLoggingPublisher](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/metrics/publishers/emf/EmfMetricLoggingPublisher.html)` 사용
+ 전체 설정 지침, 종속성 및 Lambda별 구성은 [AWS Lambda 함수에 대한 SDK 지표 게시](metric-pub-impl-emf.md)를 참조하세요.

**문제 해결 및 콘솔 출력의 경우:**
+ `[LoggingMetricPublisher](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/metrics/LoggingMetricPublisher.html)` 사용
+ 설정 안내, 형식 지정 옵션, 로컬 개발 및 문제 해결을 위한 예제는 [개발 및 디버깅용 콘솔에 대한 SDK 지표 출력](metric-pub-impl-logging.md)을 참조하세요.

## 빠른 구현 미리 보기
<a name="quick-implementation-preview"></a>

각 사용 사례에 대한 지표 사용 설정은 다음과 같습니다.

**장기 실행 애플리케이션:**

```
MetricPublisher metricsPub = CloudWatchMetricPublisher.create();
DynamoDbClient ddb = DynamoDbClient.builder()
    .overrideConfiguration(c -> c.addMetricPublisher(metricsPub))
    .build();
```

**Lambda 함수:**

```
EmfMetricLoggingPublisher emfPublisher = EmfMetricLoggingPublisher.builder()
    .namespace("MyApp")
    .build();
DynamoDbClient dynamoDb = DynamoDbClient.builder()
    .overrideConfiguration(c -> c.addMetricPublisher(emfPublisher))
    .build();
```

**개발 및 디버깅:**

```
MetricPublisher loggingPublisher = LoggingMetricPublisher.create();
S3Client s3 = S3Client.builder()
    .overrideConfiguration(c -> c.addMetricPublisher(loggingPublisher))
    .build();
```

## AWS CRT 기반 S3 클라이언트의 지표 제한
<a name="metrics-using-s3-crt-based-client"></a>

[AWS CRT 기반 S3 클라이언트](crt-based-s3-client.md)는 현재 SDK 지표 수집을 지원하지 않습니다. AWS CRT 기반 S3 클라이언트 인스턴스의 빌더는 지표 게시자를 구성하는 방법을 제공하지 [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3CrtAsyncClientBuilder.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/s3/S3CrtAsyncClientBuilder.html)않습니다.

## 지표는 언제 사용할 수 있나요?
<a name="when-are-metrics-available"></a>

지표는 일반적으로 Java용 SDK가 지표를 생성한 후 5\~10분 이내에 사용할 수 있습니다. 정확한 최신 지표를 확인하려면 Java 애플리케이션에서 지표를 전송한 후 최소 10분 후에 Cloudwatch를 확인하세요.

## 어떤 정보가 수집되나요?
<a name="what-information-is-collected"></a>

지표 수집에는 다음이 포함됩니다.
+ 성공 또는 실패 여부를 포함한 API 요청 수
+ 반환된 예외를 포함하여 API 요청에서 호출 AWS 서비스 하는에 대한 정보
+ 마샬링, 서명, HTTP 요청과 같은 다양한 작업에 소요되는 기간
+ 열린 연결 수, 보류 중인 요청 수, 사용된 HTTP 클라이언트 이름과 같은 HTTP 클라이언트 측정항목

**참고**  
사용 가능한 지표는 HTTP 클라이언트마다 다릅니다.

전체 목록은 [서비스 클라이언트 메트릭](metrics-list.md)을 참조하세요.

## 이 정보를 어떻게 사용할 수 있나요?
<a name="how-can-i-use-this-information"></a>

SDK가 수집하는 측정항목을 사용하여 애플리케이션의 서비스 클라이언트를 모니터링할 수 있습니다. 전반적인 사용 추세를 살펴보고, 이상 현상을 식별하고, 반환된 서비스 클라이언트 예외를 검토하거나, 특정 문제를 이해하기 위해 자세히 알아볼 수 있습니다. Amazon CloudWatch Logs를 사용하면 애플리케이션이 정의한 조건에 도달하는 즉시 알림을 보내는 경보를 만들 수도 있습니다.

자세한 내용은 [Amazon CloudWatch Logs 사용 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)에서 [Amazon CloudWatch 지표 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) 및 [Amazon CloudWatch 경보 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)을 참조하세요.