La AWS SDK for Java versión 1.x entró en modo de mantenimiento el 31 de julio de 2024 y estará disponible el 31 de end-of-support
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.
Habilitación de métricas para AWS SDK for Java
AWS SDK for Java Pueden generar métricas para la visualización y el monitoreo con Amazon CloudWatch
-
el rendimiento de su aplicación al acceder AWS
-
el rendimiento de tu JVMs cuando se usa 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 SDK métricas de Java
Debe agregar la siguiente dependencia de Maven para permitir el SDK envío de 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 SDK disponible en Maven Central
AWS SDK for Java las métricas están deshabilitadas de forma predeterminada. Para habilitarlo en su entorno de desarrollo local, incluya una propiedad del sistema que apunte a su archivo de credenciales de AWS seguridad al iniciar elJVM. Por ejemplo:
-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties
Debe especificar la ruta al archivo de credenciales para SDK poder cargar los puntos de datos recopilados CloudWatch para analizarlos posteriormente.
nota
Si accede AWS desde una Amazon EC2 instancia mediante el servicio de metadatos de la Amazon EC2 instancia, no necesita especificar un archivo de credenciales. En este caso, solo debe especificar:
-Dcom.amazonaws.sdk.enableDefaultMetrics
Todas las métricas capturadas por el AWS SDK for Java se encuentran 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 active la función, cada vez que se reciba una solicitud de servicio AWS desde el AWS SDK for 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 asíncrona aproximadamente una vez cada minuto. CloudWatch Una vez que se hayan cargado las métricas, puede consultarlas mediante la consola de administración de AWS Management Console
Tipos de métricas disponibles
El conjunto predeterminado de métricas se divide en tres categorías principales:
- AWS Solicita métricas
-
-
Abarca áreas como la latencia de la HTTP solicitud/respuesta, el número de solicitudes, las excepciones y los reintentos.
-
- Servicio de AWS Métricas
-
-
Incluya 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
excludeMachineMetrics
a la propiedad del sistema:-Dcom.amazonaws.sdk.enableDefaultMetrics=credentialFile=/path/aws.properties,excludeMachineMetrics
-
Más información
-
Consulte amazonaws/metrics package summary para ver una lista completa de los principales tipos de métricas predefinidas.
-
Obtenga información sobre cómo trabajar con el CloudWatch uso del AWS SDK for Java en los CloudWatch ejemplos de uso del AWS SDK for Java.
-
Obtenga más información sobre el ajuste del rendimiento en la entrada del blog Tuning the AWS SDK for Java to Improve Resiliency.