AWS SDK for Java 2.x: Umfassende Metrik-Referenz - AWS SDK for Java 2.x
Bei jeder Anfrage gesammelte MetrikenFür jeden Anforderungsversuch gesammelte Metriken

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.

AWS SDK for Java 2.x: Umfassende Metrik-Referenz

Mit dem AWS SDK for Java 2.x können Sie Metriken von den Service-Clients in Ihrer Anwendung sammeln und diese Metriken dann auf Amazon veröffentlichen (ausgeben) CloudWatch.

In diesen Tabellen sind die Metriken, die Sie sammeln können, sowie alle Anforderungen für die Nutzung des HTTP-Clients aufgeführt.

Weitere Informationen zur Aktivierung und Konfiguration von Metriken für das SDK finden Sie unter SDK-Metriken aktivieren.

Bei jeder Anfrage gesammelte Metriken

Metrikname Beschreibung Typ

ApiCallDuration

Die Dauer des API-Aufrufs. Dies schließt alle unternommenen Anrufversuche ein.

Dauer*

ApiCallSuccessful

Wahr, wenn der API-Aufruf erfolgreich war, andernfalls falsch.

Boolesch

CredentialsFetchDuration

Die Zeitdauer, die benötigt wird, um die Signaturdaten für den API-Aufruf abzurufen.

Dauer*
EndpointResolveDuration Die Dauer der Auflösung des Endpunkts, der für den API-Aufruf verwendet wurde. Dauer*

MarshallingDuration

Die Zeitdauer, die benötigt wird, um die SDK-Anfrage in eine HTTP-Anfrage umzuwandeln.

Dauer*

OperationName

Der Name des aufgerufenen Dienstvorgangs.

String

RetryCount

Die Anzahl der Wiederholungen, die das SDK bei der Ausführung der Anforderung ausgeführt hat. 0 bedeutet, dass die Anfrage beim ersten Mal funktioniert hat und dass keine Wiederholungsversuche unternommen wurden.

Weitere Hinweise zur Konfiguration des Wiederholungsverhaltens finden Sie unter. Strategien für Wiederholungsversuche

Ganzzahl

ServiceId

Die eindeutige ID für den Dienst.

String

ServiceEndpoint

Der Endpunkt für den Dienst.

URI

TokenFetchDuration

 Die Dauer des Abrufs der Signaturdaten für den API-Aufruf. Dauer*

* java.time.Duration.

Für jeden Anforderungsversuch gesammelte Metriken

Für jeden API-Aufruf sind möglicherweise mehrere Versuche erforderlich, bevor eine Antwort eingeht. Diese Metriken werden für jeden Versuch gesammelt.

Kernmetriken

Metrikname Beschreibung Typ

AwsExtendedRequestId

Die erweiterte Anfrage-ID der Serviceanfrage.

String

AwsRequestId

Die Anforderungs-ID der Serviceanfrage.

String

BackoffDelayDuration

Die Dauer, während der das SDK auf diesen API-Aufrufversuch gewartet hat. Der Wert basiert auf dem auf dem Client BackoffStrategy eingestellten Wert. Weitere Informationen finden Sie im Strategien für Wiederholungsversuche Abschnitt dieses Handbuchs.

Dauer*
ErrorType

Die Art des Fehlers, der bei einem Anrufversuch aufgetreten ist.

Folgende Werte sind möglich:

  • Throttling: Der Dienst hat mit einem Drosselungsfehler geantwortet.

  • ServerError: Der Dienst hat mit einem anderen Fehler als der Drosselung geantwortet.

  • ConfiguredTimeout: Ein Client-Timeout ist aufgetreten, entweder auf der Ebene der API-Aufrufe oder auf der Ebene der API-Aufrufversuche.

  • IO: Ein I/O Fehler ist aufgetreten.

  • Other: Sammelsurkunde für andere Fehler, die nicht in eine der oben aufgeführten Kategorien fallen.

 String
ReadThroughput

Der Lesedurchsatz des Clients, definiert als. NumberOfResponseBytesRead / (TTLB - TTFB) Dieser Wert wird in Byte pro Sekunde angegeben.

Beachten Sie, dass diese Metrik nur die Byte misst, die innerhalb von ResponseTransformer oder gelesen AsyncResponseTransformer werden. Daten, die außerhalb des Transformators gelesen werden — beispielsweise wenn der Antwortstream als Ergebnis des Transformators zurückgegeben wird — sind nicht in der Berechnung enthalten.

 Double

ServiceCallDuration

Die Dauer, die benötigt wird, um eine Verbindung mit dem Dienst herzustellen (oder eine Verbindung aus dem Verbindungspool herzustellen), die serialisierte Anfrage zu senden und die erste Antwort zu empfangen (z. B. HTTP-Statuscode und Header). Dies beinhaltet NICHT die Zeit, die zum Lesen der gesamten Antwort vom Dienst benötigt wird.

Dauer*

SigningDuration

Die Zeitdauer für das Signieren der HTTP-Anfrage.

Dauer*
TimeToFirstByte Die Zeitspanne zwischen dem Senden der HTTP-Anfrage (einschließlich des Aufbaus einer Verbindung) an den Dienst und dem Empfangen des ersten Bytes der Header in der Antwort. Dauer*
TimeToLastByte

Die Zeitspanne zwischen dem Senden der HTTP-Anfrage (einschließlich des Aufbaus einer Verbindung) an den Dienst und dem Empfangen des letzten Bytes der Antwort.

Beachten Sie, APIs dass diese Metrik für Streaming-Antworten die Zeit bis zum AsyncResponseTransformer Abschluss des ResponseTransformer Oder umfasst.

 Dauer*

UnmarshallingDuration

Die Zeitdauer für das Unmarshalling der HTTP-Antwort auf eine SDK-Antwort.

Hinweis: Bei Streaming-Vorgängen beinhaltet dies nicht die Zeit zum Lesen der Antwortnutzdaten.

Dauer*

* java.time.Duration.

HTTP-Metriken

Metrikname Beschreibung Typ HTTP-Client erforderlich*

AvailableConcurrency

Die Anzahl zusätzlicher gleichzeitiger Anfragen, die der HTTP-Client unterstützt, ohne dass neue Verbindungen zum Zielserver hergestellt werden.

Bei HTTP/1-Vorgängen entspricht dies der Anzahl der inaktiven TCP-Verbindungen, die mit dem Dienst eingerichtet wurden. Bei HTTP/2-Vorgängen entspricht dies der Anzahl der inaktiven Streams.

Hinweis: Dieser Wert variiert je nach Implementierung des HTTP-Clients:

  • Apache-Client: Der Wert gilt für den gesamten HTTP-Client

  • Netty-Client: Der Wert gilt pro Endpunkt

  • AWS CRT-basierter Client: Der Wert gilt pro Endpunkt

Der Wert ist auf eine einzelne HTTP-Clientinstanz beschränkt und schließt die Parallelität anderer HTTP-Clients in derselben JVM aus.

Ganzzahl

 Apache, Netty, CRT

ConcurrencyAcquireDuration

Die Zeitdauer, die benötigt wird, um einen Kanal aus dem Verbindungspool zu beziehen.

Bei HTTP/1-Vorgängen entspricht ein Kanal einer TCP-Verbindung. Bei HTTP/2-Operationen entspricht ein Kanal einem HTTP/2-Stream-Kanal.

Der Erwerb eines neuen Kanals kann Zeit beinhalten für:

  1. Es wird auf eine Parallelitätsgenehmigung gewartet, die durch die maximale Parallelitätskonfiguration des Clients eingeschränkt ist.

  2. Eine neue Verbindung wird hergestellt, falls keine bestehende Verbindung im Pool verfügbar ist.

  3. Durchführung des TLS-Handshakes und der TLS-Verhandlung, falls TLS aktiviert ist.

Dauer*

Apache, Netty, CRT

HttpClientName

Der Name des für die Anfrage verwendeten HTTPs.

String

Apache, Netty, CRT

HttpStatusCode

Der Statuscode der HTTP-Antwort.

Ganzzahl

Any

LeasedConcurrency

Die Anzahl der Anfragen, die der HTTP-Client derzeit ausführt.

Bei HTTP/1-Vorgängen entspricht dies der Anzahl der aktiven TCP-Verbindungen mit dem Dienst (ohne inaktive Verbindungen). Bei HTTP/2-Vorgängen entspricht dies der Anzahl der aktiven HTTP-Streams mit dem Dienst (ohne Stream-Kapazität im Leerlauf).

Hinweis: Dieser Wert variiert je nach Implementierung des HTTP-Clients:

  • Apache-Client: Der Wert gilt für den gesamten HTTP-Client

  • Netty-Client: Der Wert gilt pro Endpunkt

  • AWS CRT-basierter Client: Der Wert gilt pro Endpunkt

Der Wert ist auf eine einzelne HTTP-Clientinstanz beschränkt und schließt die Parallelität anderer HTTP-Clients in derselben JVM aus.

Ganzzahl

Apache, Netty, CRT

LocalStreamWindowSize

Die lokale HTTP/2-Fenstergröße in Byte für den Stream, der diese Anforderung ausführt.

Ganzzahl

Netty

MaxConcurrency

Die maximale Anzahl gleichzeitiger Anfragen, die der HTTP-Client unterstützt.

Bei HTTP/1-Vorgängen entspricht dies der maximalen Anzahl von TCP-Verbindungen, die der HTTP-Client bündeln kann. Bei HTTP/2-Vorgängen entspricht dies der maximalen Anzahl von Streams, die der HTTP-Client bündeln kann.

Hinweis: Dieser Wert variiert je nach Implementierung des HTTP-Clients:

  • Apache-Client: Der Wert gilt für den gesamten HTTP-Client

  • Netty-Client: Der Wert gilt pro Endpunkt

  • AWS CRT-basierter Client: Der Wert gilt pro Endpunkt

Der Wert ist auf eine einzelne HTTP-Clientinstanz beschränkt und schließt die Parallelität anderer HTTP-Clients in derselben JVM aus.

Ganzzahl

Apache, Netty, CRT

PendingConcurrencyAcquires

Die Anzahl der Anfragen, die auf Parallelität vom HTTP-Client warten.

Bei HTTP/1-Vorgängen entspricht dies der Anzahl der Anfragen, die darauf warten, dass eine TCP-Verbindung hergestellt wird oder aus dem Verbindungspool zurückkehrt. Bei HTTP/2-Operationen entspricht dies der Anzahl der Anfragen, die auf einen neuen Stream (und möglicherweise eine neue HTTP/2-Verbindung) aus dem Verbindungspool warten.

Hinweis: Dieser Wert variiert je nach Implementierung des HTTP-Clients:

  • Apache-Client: Der Wert gilt für den gesamten HTTP-Client

  • Netty-Client: Der Wert gilt pro Endpunkt

  • AWS CRT-basierter Client: Der Wert gilt pro Endpunkt

Der Wert ist auf eine einzelne HTTP-Clientinstanz beschränkt und schließt die Parallelität anderer HTTP-Clients in derselben JVM aus.

Ganzzahl

Apache, Netty, CRT

RemoteStreamWindowSize

Die Größe des Remote-HTTP/2-Fensters in Byte für den Stream, der diese Anforderung ausführt.

Ganzzahl

Netty

* java.time.Duration.

Die in der Spalte verwendeten Begriffe bedeuten: