AWS SDK for Java 2.x의 SDK 지표 게시 - AWS SDK for Java 2.x
SDK 지표 사용 시작하기빠른 구현 미리 보기AWS CRT 기반 S3 클라이언트 사용지표는 언제 사용할 수 있나요?어떤 정보가 수집되나요?이 정보를 어떻게 사용할 수 있나요?

AWS SDK for Java 2.x의 SDK 지표 게시

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

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

SDK 지표 사용 시작하기

애플리케이션에서 지표 수집을 사용하려면 사용 사례에 따라 MetricPublisher 인터페이스의 적절한 구현을 선택하고 자세한 설정 안내를 따릅니다.

장기 실행 애플리케이션의 경우:

AWS Lambda 함수의 경우:

문제 해결 및 콘솔 출력의 경우:

빠른 구현 미리 보기

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

장기 실행 애플리케이션:

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 클라이언트의 지표 제한 사항

AWS CRT 기반 S3 클라이언트는 현재 SDK 지표 수집을 지원하지 않습니다. AWS CRT 기반 S3 클라이언트 인스턴스의 빌더인 S3CrtAsyncClientBuilder는 지표 게시자를 구성하는 메서드를 제공하지 않습니다.

지표는 언제 사용할 수 있나요?

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

어떤 정보가 수집되나요?

지표 수집에는 다음이 포함됩니다.

  • 성공 또는 실패 여부를 포함한 API 요청 수

  • 반환된 예외를 포함하여 API 요청에서 호출한 AWS 서비스에 대한 정보

  • 마샬링, 서명, HTTP 요청과 같은 다양한 작업에 소요되는 기간

  • 열린 연결 수, 보류 중인 요청 수, 사용된 HTTP 클라이언트 이름과 같은 HTTP 클라이언트 측정항목

참고

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

전체 목록은 서비스 클라이언트 메트릭을 참조하세요.

이 정보를 어떻게 사용할 수 있나요?

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

자세한 내용은 Amazon CloudWatch Logs 사용 설명서에서 Amazon CloudWatch 지표 사용 및 Amazon CloudWatch 경보 사용을 참조하세요.