에서 SDK 지표 게시 AWS SDK for Java 2.x

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

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

SDK 지표 시작하기

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

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

• CloudWatchMetricPublisher 사용

• 전체 설정 지침, 코드 예제 및 구성 옵션은 장기 실행 애플리케이션의 SDK 지표 게시를 참조하세요.

AWS Lambda 함수의 경우:

• EmfMetricLoggingPublisher 사용

• 전체 설정 지침, 종속성 및 Lambda별 구성은 AWS Lambda 함수에 대한 SDK 지표 게시를 참조하세요.

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

• LoggingMetricPublisher 사용

• 로컬 개발 및 문제 해결을 위한 설정 지침, 형식 지정 옵션 및 예제는 콘솔로 SDK 지표 출력을 참조하세요.

빠른 구현 미리 보기

각 사용 사례에 대한 지표 활성화는 다음과 같습니다.

장기 실행 애플리케이션:

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();

CRT 기반 S3 클라이언트의 AWS 지표 제한

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 Logs 지표 사용 및 Amazon CloudWatch Logs 경보 Amazon CloudWatch 사용을 참조하세요 Amazon CloudWatch.