Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Utilice SDK las métricas del AWS SDK for Java

Con la AWS SDK for Java versión 2.x, puede recopilar métricas sobre los clientes de servicio de su aplicación, analizar los resultados y Amazon CloudWatch, después, actuar en consecuencia.

De forma predeterminada, la recopilación de métricas está deshabilitada en. SDK En este tema se explica cómo activarlo y configurarlo.

Requisitos previos

Antes de poder activar y utilizar las métricas, debe completar los siguientes pasos:

Habilitar la recopilación de métricas

Puede habilitar las métricas en su aplicación para un cliente de servicio o para solicitudes individuales.

Habilitar métricas para una solicitud específica

La siguiente clase muestra cómo habilitar el publicador de CloudWatch métricas para una solicitud Amazon DynamoDB. Utiliza la configuración predeterminada del publicador de métricas.

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

Habilite las métricas resumidas para un cliente de servicio específico

En el siguiente fragmento de código, se muestra cómo habilitar un publicador de CloudWatch métricas con la configuración predeterminada para un cliente de servicio.

MetricPublisher metricsPub = CloudWatchMetricPublisher.create();

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

Personalice el editor de métricas

La siguiente clase muestra cómo configurar una configuración personalizada para el publicador de métricas de un cliente de servicio específico. Las personalizaciones incluyen cargar un perfil específico, especificar una AWS región a la que el publicador de métricas envía las solicitudes y personalizar la frecuencia a la que envía las métricas. 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();
    }
}

Las personalizaciones que se muestran en el fragmento anterior tienen los siguientes efectos.

¿Cuándo están disponibles las métricas?

Por lo general, las métricas están disponibles entre 5 y 10 minutos después SDK de que Java las emita. Para obtener up-to-date métricas precisas, consulte Cloudwatch al menos 10 minutos después de emitir las métricas desde sus aplicaciones Java.

¿Qué información se recopila?

La recopilación de métricas incluye lo siguiente:

Para ver una lista completa, consulte Métricas de los clientes de servicio.

¿Cómo puedo usar esta información?

Puede usar las métricas SDK recopiladas para monitorear los clientes de servicio de su aplicación. Puede analizar las tendencias generales de uso, identificar anomalías, revisar las excepciones detectadas por los clientes del servicio o profundizar para entender un problema concreto. También puede crear alarmas que le notifiquen tan pronto como su aplicación alcance una condición que usted defina. Amazon CloudWatch

Para obtener más información, consulte Uso de Amazon CloudWatch métricas y Uso de Amazon CloudWatch alarmas en la Guía del Amazon CloudWatch usuario.