Habilitación de métricas para AWS SDK for Java - AWS SDK for Java 1.x
Cómo habilitar la generación de métricas de SDKTipos de métricas disponiblesMás información

Anunciamos la próxima versión end-of-support para AWS SDK for Java (v1). Se recomienda que migre a AWS SDK for Java versión 2. Para ver las fechas, los detalles adicionales y la información sobre cómo realizar la migración, consulte el anuncio enlazado.

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 que midan:

  • el rendimiento de su aplicación al acceder AWS

  • el rendimiento de sus máquinas virtuales 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 agregar 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.

AWS SDK for 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

Debe especificar la ruta al archivo de credenciales para que el SDK pueda cargar los puntos de datos recopilados CloudWatch para analizarlos más adelante.

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 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 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:

AWS Solicita métricas

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

    RequestMetric 131111
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.

    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