Version AWS SDK for Java 1.x wurde am 31. Juli 2024 in den Wartungsmodus versetzt und wird end-of-support
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
-
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
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 Console
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.
-
- AWS-Service Metriken
-
-
Schließen Sie AWS-Service spezifische Daten ein, z. B. den Durchsatz und die Byteanzahl für S3-Uploads und -Downloads.
-
- Maschinenmetriken
-
-
Enthalten die Laufzeitumgebung, darunter Heap-Speicher, Anzahl der Threads und geöffneter Datei-Deskriptoren.
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
-
In der amazonaws/metrics-Paketübersicht finden Sie eine vollständige Liste der vordefinierten Standardmetrik-Typen.
-
Weitere Informationen zur CloudWatch Verwendung von finden Sie AWS SDK for Java in CloudWatch Beispielen mit der. AWS SDK for Java
-
Weitere Informationen zur Leistungsoptimierung finden Sie im Blogbeitrag Tuning the AWS SDK for Java to Improve Resiliency
.