Metriken aktivieren für AWS SDK for Java - AWS SDK for Java 1.x

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.

Metriken aktivieren 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 SDK Java-Metriken

Sie müssen die folgende Maven-Abhängigkeit hinzufügen, damit Metriken SDK an CloudWatch gesendet werden können.

<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 von, die bei Maven Central SDK 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 von auf Ihre AWS Sicherheitsanmeldedatei verweist. JVM Beispielsweise:

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

Sie müssen den Pfad zu Ihrer Anmeldeinformationsdatei angeben, damit die gesammelten Datenpunkte zur CloudWatch späteren Analyse hochgeladen werden SDK können.

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