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

의 SDK 지표 사용 AWS SDK for Java

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

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

사전 조건

지표를 활성화하고 사용하려면 먼저 다음 단계를 완료해야 합니다.

지표 수집을 활성화하는 방법

서비스 클라이언트 또는 개별 요청에 대해 애플리케이션에서 지표를 활성화할 수 있습니다.

특정 요청에 대한 지표 활성화

다음 클래스는 요청에 대해 CloudWatch 지표 게시자를 활성화하는 방법을 보여줍니다 Amazon DynamoDB. 기본 메트릭 게시자 구성을 사용합니다.

import software.amazon.awssdk.metrics.MetricPublisher;
import software.amazon.awssdk.metrics.publishers.cloudwatch.CloudWatchMetricPublisher;
import software.amazon.awssdk.services.dynamodb.DynamoDbClient;
import software.amazon.awssdk.services.dynamodb.model.ListTablesRequest;

public class DefaultConfigForRequest {
    // Use one MetricPublisher for your application. It can be used with requests or service clients.
    static MetricPublisher metricsPub = CloudWatchMetricPublisher.create();

    public static void main(String[] args) {
        DynamoDbClient ddb = DynamoDbClient.create();
        // Publish metrics the for ListTables operation.
        ddb.listTables(ListTablesRequest.builder()
            .overrideConfiguration(c -> c.addMetricPublisher(metricsPub))
            .build());

        // Perform more work in your application.

        // A MetricsPublisher has its own lifecycle independent of any service client or request that uses it.
        // If you no longer need the publisher, close it to free up resources.
        metricsPub.close();  // All metrics stored in memory are flushed to CloudWatch.

        // Perform more work with the DynamoDbClient instance without publishing metrics.
        // Close the service client when you no longer need it.
        ddb.close();
    }
}

특정 서비스 클라이언트에 대한 요약 지표 활성화

다음 코드 조각은 서비스 클라이언트에 대한 기본 설정으로 CloudWatch 지표 게시자를 활성화하는 방법을 보여줍니다.

MetricPublisher metricsPub = CloudWatchMetricPublisher.create();

DynamoDbClient ddb = DynamoDbClient.builder()
          .overrideConfiguration(c -> c.addMetricPublisher(metricsPub))
          .build();

지표 게시자 사용자 지정

다음 클래스는 특정 서비스 클라이언트에 대한 지표 게시자에 대한 사용자 지정 구성을 설정하는 방법을 보여줍니다. 사용자 지정에는 특정 프로필 로드, 지표 게시자가 요청을 보내는 AWS 리전 지정, 게시자가 지표를 보내는 빈도 사용자 지정이 포함됩니다 CloudWatch.

import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.core.metrics.CoreMetric;
import software.amazon.awssdk.metrics.MetricPublisher;
import software.amazon.awssdk.metrics.publishers.cloudwatch.CloudWatchMetricPublisher;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.cloudwatch.CloudWatchAsyncClient;
import software.amazon.awssdk.services.dynamodb.DynamoDbClient;

import java.time.Duration;

public class CustomConfigForDDBClient {
    // Use one MetricPublisher for your application. It can be used with requests or service clients.
    static MetricPublisher metricsPub = CloudWatchMetricPublisher.builder()
        .cloudWatchClient(CloudWatchAsyncClient.builder()
            .region(Region.US_WEST_2)
            .credentialsProvider(ProfileCredentialsProvider.create("cloudwatch"))
            .build())
        .uploadFrequency(Duration.ofMinutes(5))
        .maximumCallsPerUpload(100)
        .namespace("ExampleSDKV2Metrics")
        .detailedMetrics(CoreMetric.API_CALL_DURATION)
        .build();

    public static void main(String[] args) {
        DynamoDbClient ddb = DynamoDbClient.builder()
            .overrideConfiguration(c -> c.addMetricPublisher(metricsPub))
            .build();
        // Publish metrics for DynamoDB operations.
        ddb.listTables();
        ddb.describeEndpoints();
        ddb.describeLimits();
        // Perform more work in your application.

        // A MetricsPublisher has its own lifecycle independent of any service client or request that uses it.
        // If you no longer need the publisher, close it to free up resources.
        metricsPub.close();  // All metrics stored in memory are flushed to CloudWatch.


        // Perform more work with the DynamoDbClient instance without publishing metrics.
        // Close the service client when you no longer need it.
        ddb.close();
    }
}

이전 코드 조각에 표시된 사용자 지정은 다음과 같은 효과가 있습니다.

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

지표는 일반적으로 JavaSDK용에서 지표를 내보낸 후 5~10분 이내에 사용할 수 있습니다. Java 애플리케이션에서 지표를 내보낸 후 최소 10분 후에 Cloudwatch에서 정확한 up-to-date 지표를 확인하세요.

어떤 정보가 수집되나요?

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

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

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

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

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