Aktivierung von Metriken für AWS SDK for Java - AWS SDK for Java 1.x
Wie aktiviert man die Generierung von Java-SDK-MetrikenVerfügbare Arten von MetrikenWeitere Informationen

Version AWS SDK for Java 1.x wurde am 31. Juli 2024 in den Wartungsmodus versetzt und wird end-of-supportam 31. Dezember 2025 verfügbar sein. Wir empfehlen Ihnen, auf den zu migrieren AWS SDK for Java 2.x, um weiterhin neue Funktionen, Verfügbarkeitsverbesserungen und Sicherheitsupdates zu erhalten.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Aktivierung von Metriken für AWS SDK for Java

AWS SDK for Java Sie können mit Amazon Metriken für die Visualisierung und Überwachung generieren CloudWatch, die Folgendes messen:

  • die Leistung Ihrer Anwendung beim Zugriff AWS

  • die Leistung Ihres JVMs bei Verwendung mit AWS

  • Details der Laufzeitumgebung wie z. B. Heap-Speicher, Anzahl der Threads und geöffneter Datei-Deskriptoren

Wie aktiviert man die Generierung von Java-SDK-Metriken

Sie müssen die folgende Maven-Abhängigkeit hinzufügen, damit das SDK Metriken an CloudWatch senden kann.

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

* Ersetzen Sie die Versionsnummer durch die neueste Version des SDK, die bei Maven Central verfügbar ist.

AWS SDK for Java Metriken sind standardmäßig deaktiviert. Um es für Ihre lokale Entwicklungsumgebung zu aktivieren, fügen Sie eine Systemeigenschaft hinzu, die beim Start der JVM auf Ihre AWS Sicherheitsanmeldedatei verweist. Zum Beispiel:

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

Sie müssen den Pfad zu Ihrer Anmeldeinformationsdatei angeben, damit das SDK die gesammelten Datenpunkte zur späteren Analyse hochladen kann. CloudWatch

Anmerkung

Wenn Sie AWS von einer Amazon EC2 Instanz aus zugreifen, die den Amazon EC2 Instanz-Metadatendienst verwendet, müssen Sie keine Anmeldeinformationsdatei angeben. In diesem Fall ist nur Folgendes anzugeben:

-Dcom.amazonaws.sdk.enableDefaultMetrics

Alle von der erfassten Metriken AWS SDK for Java befinden sich unter dem Namespace AWSSDK/Java und werden in die CloudWatch Standardregion (us-east-1) hochgeladen. Wenn Sie die Region ändern möchten, geben Sie sie mit dem Attribut cloudwatchRegion in der Systemeigenschaft an. Um die CloudWatch Region beispielsweise auf us-east-1 festzulegen, verwenden Sie:

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

Sobald Sie die Funktion aktiviert haben, werden bei jeder Serviceanfrage AWS von metrische Datenpunkte generiert AWS SDK for Java, für die statistische Zusammenfassung in die Warteschlange gestellt und asynchron hochgeladen, CloudWatch etwa einmal pro Minute. Sobald die Metriken hochgeladen wurden, können Sie sie mithilfe von visualisieren AWS Management Consoleund Alarme für potenzielle Probleme wie Speicherverlust, Verlust von Dateideskriptoren usw. einrichten.

Verfügbare Arten von Metriken

Die Standardmetriken werden in drei Hauptkategorien unterteilt:

AWS Metriken anfordern

  • Deckt Bereiche wie die Latenz der HTTP-Anforderung/‑Antwort, die Anzahl der Anfragen, Ausnahmen und Wiederholungen ab.

    RequestMetric 131111
AWS-Service Metriken

  • Schließen Sie AWS-Service spezifische Daten ein, z. B. den Durchsatz und die Byteanzahl für S3-Uploads und -Downloads.

    ServiceMetric 131111
Maschinenmetriken

  • Enthalten die Laufzeitumgebung, darunter Heap-Speicher, Anzahl der Threads und geöffneter Datei-Deskriptoren.

    MachineMetric 131111

    Wenn Sie Maschinenmetriken ausschließen möchten, fügen Sie excludeMachineMetrics in die Systemeigenschaft ein:

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

Weitere Informationen