La versión AWS SDK para Java 1.x finalizó su 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.
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.
Habilitar las métricas para AWS SDK para Java
AWS SDK para Java Pueden generar métricas para su visualización y monitoreo con Amazon CloudWatch
-
el rendimiento de su aplicación al acceder AWS
-
el rendimiento 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
Debes añadir la siguiente dependencia de Maven para que el SDK pueda enviar métricas a él. 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
AWS SDK para Java las métricas 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
Debes especificar la ruta al archivo de credenciales para que el SDK pueda cargar allí los puntos de datos recopilados CloudWatch para su posterior análisis.
nota
Si accedes AWS desde una Amazon EC2 instancia mediante el servicio de metadatos de la Amazon EC2 instancia, no necesitas especificar un archivo de credenciales. En este caso, solo debe especificar:
-Dcom.amazonaws.sdk.enableDefaultMetrics
Todas las métricas capturadas por el AWS SDK para Java están en el espacio de nombres AWSSDK/Java y se cargan en la región CloudWatch predeterminada (us-east-1). Para cambiar la región, especifíquela usando el atributo cloudwatchRegion en la propiedad del sistema. Por ejemplo, para establecer la CloudWatch región en us-east-1, usa:
-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,cloudwatchRegion={region_api_default}
Una vez que habilites la función, cada vez que se presente una solicitud de servicio AWS desde The AWS SDK para Java, se generarán puntos de datos métricos, se pondrán en cola para obtener un resumen estadístico y se cargarán de forma asincrónica aproximadamente una vez por minuto. CloudWatch Una vez que se hayan cargado las métricas, puede consultarlas mediante la consola de administración de Consola de administración de AWS
Tipos de métricas disponibles
El conjunto predeterminado de métricas se divide en tres categorías principales:
- AWS Métricas de solicitud
-
-
Abarca áreas como la latencia del HTTP request/response, el número de solicitudes, las excepciones y los reintentos.
-
- Servicio de AWS Métricas
-
-
Incluye datos Servicio de AWS específicos, como el rendimiento y el recuento de bytes de las cargas y descargas de S3.
-
- 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.
Si desea excluir las métricas de la máquina, añada
excludeMachineMetricsa la propiedad del sistema:-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,excludeMachineMetrics
-
Más información
-
Consulta el resumen amazonaws/metrics del paquete para ver una lista completa de los tipos de métricas principales predefinidos.
-
Obtenga más información sobre cómo trabajar con el CloudWatch uso de los CloudWatch ejemplos que aparecen AWS SDK para Java en AWS SDK para Java.
-
Obtenga más información sobre el ajuste del rendimiento en la entrada del
blog Ajustar AWS SDK para Java para mejorar la resiliencia.