Habilitación de métricas para el AWS SDK para Java - AWS SDK para Java 1.x

AWS SDK para Java 1.x ha entrado en modo de mantenimiento el 31 de julio de 2024 y llegará al final de soporte el 31 de diciembre de 2025. Le recomendamos que migre a AWS SDK for Java 2.x para seguir recibiendo nuevas características, mejoras de disponibilidad y actualizaciones de seguridad.

Habilitación de métricas para el AWS SDK para Java

El AWS SDK para Java puede generar métricas para la visualización y la monitorización con Amazon CloudWatch que midan:

  • el desempeño de la aplicación al obtener acceso a AWS

  • el desempeño de sus JVM cuando se utilizan con AWS

  • los detalles del entorno en tiempo de ejecución, como la memoria del montón, el número de subprocesos y los descriptores de archivos abiertos

Cómo habilitar la generación de métricas de SDK

Debe añadir la siguiente dependencia de Maven para permitir que el SDK envíe métricas a CloudWatch.

<dependencyManagement> <dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk-bom</artifactId> <version>1.12.490*</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <dependencies> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk-cloudwatchmetrics</artifactId> <scope>provided</scope> </dependency> <!-- Other SDK dependencies. --> </dependencies>

*Sustituya el número de versión por la última versión del SDK disponible en Maven Central.

Las métricas de AWS SDK para Java están deshabilitadas de forma predeterminada. Para habilitarlas en el entorno de desarrollo local, incluya una propiedad del sistema que apunte al archivo de credenciales de seguridad de AWS cuando inicie la JVM. Por ejemplo:

-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties

Debe especificar la ruta a su archivo de credenciales de forma que el SDK pueda cargar los puntos de datos recopilados en para su posterior análisis.

nota

Si tiene acceso a AWS desde una instancia de Amazon EC2 mediante el servicio de metadatos de instancias de Amazon EC2, no es necesario especificar un archivo de credenciales. En este caso, solo debe especificar:

-Dcom.amazonaws.sdk.enableDefaultMetrics

Todas las métricas obtenidas por el AWS SDK para Java están en el espacio de nombres AWSSDK/Java y se cargan en la región predeterminada CloudWatch (us-east-1). Para cambiar la región, especifíquela usando el atributo cloudwatchRegion en la propiedad del sistema. Por ejemplo, para definir la región de CloudWatch como us-east-1, utilice:

-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,cloudwatchRegion={region_api_default}

Una vez habilitada la característica, cada vez que se realice una solicitud de servicio a AWS desde el AWS SDK para Java, se generarán puntos de datos de métricas, se pondrán en cola para un resumen estadístico y se cargarán de forma asíncrona en CloudWatch alrededor de una vez cada minuto. Una vez que se hayan cargado las métricas, puede consultarlas mediante la consola de administración de Consola de administración de AWS y definir alarmas para posibles problemas como fuga de memoria, fuga de descriptores de archivos, etc.

Tipos de métricas disponibles

El conjunto predeterminado de métricas se divide en tres categorías principales:

AWSMétricas de solicitudes de
  • Cubren áreas como la latencia de la solicitud/respuesta HTTP, el número de solicitudes, las excepciones y los reintentos.

    RequestMetric 131111
Servicio de AWSMétricas de
  • Incluyen datos específicos de los Servicio de AWS, como el rendimiento y el número de bytes de cargas y descargas de S3.

    ServiceMetric 131111
Métricas de la máquina
  • Cubren el entorno en tiempo de ejecución, como la memoria del montón, el número de subprocesos y los descriptores de archivos abiertos.

    MachineMetric 131111

    Si desea excluir las métricas de la máquina, añada excludeMachineMetrics a la propiedad del sistema:

    -Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,excludeMachineMetrics

Más información