AWS X-RayMetriken für das X-Ray-SDK SDK for Java - AWS X-Ray

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 X-RayMetriken für das X-Ray-SDK SDK for Java

In diesem Thema werden der AWS X-Ray-Namespace, die Metriken und Dimensionen beschrieben. Sie können das X-Ray-SDK SDK for Java verwenden, um unbeschwerte Amazon CloudWatch CloudWatch-Metriken aus Ihren gesammelten X-Ray-Segmenten zu veröffentlichen. Diese Metriken werden von der Start- und Endzeit des Segments sowie den Status-Flags für Fehler, Ausfall und Ablehnung abgeleitet. Mit diesen Trace-Metriken können Sie Wiederholungen und Abhängigkeitsprobleme in Teilsegmenten anzeigen.

CloudWatch istim Grundein Repository für Metriken. Eine Metrik ist ein grundlegendes Konzept in CloudWatch und stellt einen zeitlich geordneten Satz an Datenpunkten dar. Sie (oderAWS-Services) veröffentlichen Metrik-Datenpunkte in CloudWatch und rufen später Statistiken zu diesen Datenpunkten als geordneten Satz von Zeitreihendaten ab.

Metriken werden eindeutig durch einen Namen, ein Namespace und eine oder mehrere Dimensionen definiert. Jeder Datenpunkt verfügt über einen Zeitstempel und optional über eine Maßeinheit. Wenn Sie Statistiken anfordern, wird der zurückgegebene Datenstrom durch den Namespace, den Metrik-Namen und die Dimension identifiziert.

Weitere Informationen über CloudWatch finden Sie im Amazon CloudWatch-Benutzerhandbuch.

X-Ray-Cay-Metriken

Der ServiceMetrics/SDK-Namespace enthält die folgenden Metriken.

Metrik Verfügbare Statistiken Beschreibung Einheiten

Latency

Durchschnitt, Minimum, Maximum, Anzahl

Die Differenz zwischen der Start- und Endzeit Durchschnitt, Minimum und Maximum beschreiben Betriebslatenz. „Anzahl“ beschreibt die Anzahl der Aufrufe.

Millisekunden

ErrorRate

Durchschnitt, Summe

Die Rate der Anforderungen, die mit dem Statuscode „4xx Client Error“ fehlgeschlagen sind, was zu einem Fehler führt.

Prozent

FaultRate

Durchschnitt, Summe

Die Rate der Traces, die mit dem Statuscode „5xx Server Error“ fehlgeschlagen sind, was zu einem Fehler führte.

Prozent

ThrottleRate

Durchschnitt, Summe

Die Rate der abgelehnten Traces, die einen 419-Statuscode zurückgeben. Dies ist eine Teilmenge der ErrorRate-Metrik.

Prozent

OkRate

Durchschnitt, Summe

Die Rate der verfolgten Anforderungen, die zu einem OK-Statuscode führen.

Prozent

X-Ray-CloudWatch-Abmessungen

Verwenden Sie die Dimensionen in der folgenden Tabelle, um die für Ihre X-Ray-instrumentierten Java-Anwendungen zu verfeinern.

Dimension Beschreibung

ServiceType

Der Service-Typ, z. B. AWS::EC2::Instance oder NONE, falls nicht bekannt.

ServiceName

Der kanonische Name für den Service.

Aktivieren X-Ray-CloudWatch-Metriken

Mit dem folgenden Verfahren können Sie Trace-Metriken in Ihrer instrumentierten Java-Anwendung aktivieren.

So konfigurieren Sie Trace-Metriken

  1. Fügen Sie das aws-xray-recorder-sdk-metrics-Paket als Maven-Abhängigkeit hinzu. Weitere Informationen finden Sie unterX-Ray-SDK SDK for Java Java-Submoduleaus.

  2. Aktivieren Sie ein neues MetricsSegmentListener() als Teil des globalen Recorder-Builds.

    Beispiel src/com/myapp/web/Startup.java

    import com.amazonaws.xray.AWSXRay; import com.amazonaws.xray.AWSXRayRecorderBuilder; import com.amazonaws.xray.plugins.EC2Plugin; import com.amazonaws.xray.plugins.ElasticBeanstalkPlugin; import com.amazonaws.xray.strategy.sampling.LocalizedSamplingStrategy; @Configuration public class WebConfig { ... static { AWSXRayRecorderBuilder builder = AWSXRayRecorderBuilder .standard() .withPlugin(new EC2Plugin()) .withPlugin(new ElasticBeanstalkPlugin()) .withSegmentListener(new MetricsSegmentListener()); URL ruleFile = WebConfig.class.getResource("/sampling-rules.json"); builder.withSamplingStrategy(new LocalizedSamplingStrategy(ruleFile)); AWSXRay.setGlobalRecorder(builder.build()); } }
  3. Stellen Sie den CloudWatch-Agent bereit, Metriken mit Amazon Elastic Compute Cloud (Amazon EC2), Amazon Elastic Container Service (Amazon ECS) oder Amazon Elastic Kubernetes Service (Amazon EKS) zu sammeln:

  4. Konfigurieren Sie das SDK für die Kommunikation mit dem CloudWatch-Agent. Standardmäßig kommuniziert das SDK mit dem CloudWatch-Agent über die Adresse127.0.0.1aus. Sie können alternative Adressen konfigurieren, indem Sie die Umgebungsvariable oder die Java-Eigenschaft auf address:port festlegen.

    Beispiel Umgebungsvariable

    AWS_XRAY_METRICS_DAEMON_ADDRESS=address:port

    Beispiel Java-Eigenschaft

    com.amazonaws.xray.metrics.daemonAddress=address:port

So überprüfen Sie die Konfiguration

  1. Melden Sie sich bei AWS Management Console an und öffnen Sie die CloudWatch-Konsole unter https://console.aws.amazon.com/cloudwatch/.

  2. Ostiften Sie dasMetrikenum den Zustrom Ihrer Metriken zu überwachen.

  3. (Optional) In der CloudWatch-KonsoleProtokolleÖffnen Sie die RegisterkarteServiceMetricsSDKProtokollgruppe. Suchen Sie nach einem Protokolldatenstrom, der den Host-Metriken entspricht, und bestätigen Sie die Protokollmeldungen.