Konfigurieren von Samplingregeln in der X-Ray - 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.

Konfigurieren von Samplingregeln in der X-Ray

Sie können die AWS X-Ray-Konsole verwenden, um Samplingregeln für Ihre Services zu konfigurieren. Das X-Ray SDKAWSServices, dieaktive AblaufverfolgungBei Samplingkonfiguration bestimmen Sie anhand von Samplingregeln, welche Anforderungen aufgezeichnet werden.

Konfigurieren von -Samplingregeln

Sie können Sampling für die folgenden Anwendungsfälle konfigurieren:

  • API-Gateway-Eintrittspunkt— API Gateway unterstützt Sampling und aktive Ablaufverfolgung. Informationen zum Aktivieren der aktiven Ablaufverfolgung für eine API-Stufe finden Sie unter Unterstützung von Amazon API Gateway Gateway-Unterstützung fürAWS X-Ray.

  • AWS AppSync–AWS AppSyncunterstützt Sampling und aktive Ablaufverfolgung. So aktivieren Sie die aktive AblaufverfolgungAWS AppSyncAnforderungen, sieheAblaufverfolgungsmitAWSX-Rayaus.

  • X-Ray SDK auf Rechnerplattformen— Bei Verwendung von Rechenplattformen wie Amazon EC2, Amazon ECS oderAWS Elastic Beanstalkwird Sampling unterstützt, wenn die Anwendung nicht mit dem aktuellen X-Röntgen-SDK instrumentiert wurde.

Anpassen von Samplingregeln

Durch das Anpassen von Samplingregeln können Sie die Menge der von Ihnen aufgezeichneten Daten steuern. Sie können auch das Sampling-Verhalten ändern, ohne Ihren Code zu ändern oder erneut bereitzustellen. Samplingregeln teilen dem X-Ring-SDK mit, wie viele Anfragen für einen Kriteriensatz aufgezeichnet werden. Das X-Ring-SDK zeichnet standardmäßig pro Sekunde die erste Anforderung und fünf Prozent aller zusätzlichen Anfragen auf. Eine Anfrage pro Sekunde ist das Reservoir. Dadurch wird sichergestellt, dass jede Sekunde mindestens eine Ablaufverfolgung aufgezeichnet wird, solange der Dienst Anfragen verarbeitet. Fünf Prozent ist die Rate, mit der die über die Reservoirgröße hinausgehenden Anforderungen geprüft werden.

Sie können das X-Ring-SDK so konfigurieren, dass es Samplingregeln aus einem JSON-Dokument liest, das Sie in Ihren Code einschließen. Wenn Sie jedoch mehrere Instances Ihres Services ausführen, führt jede Instance das Sampling unabhängig aus. Dies bewirkt, dass sich der Gesamtprozentsatz der geprüften Anforderungen erhöht, da die Reservoirs aller Instances effektiv zusammengezählt werden. Darüber hinaus müssen Sie Ihren Code erneut bereitstellen, um lokale Samplingregeln zu aktualisieren.

Durch die Definition von Samplingregeln in der X-Ray-KonsoleKonfigurieren des SDKsum Regeln aus dem X-Ring-Service zu lesen, können Sie diese beiden Probleme vermeiden. Der Service verwaltet die Reservoirs für jede Regel und weist jeder Instance Ihres Services Kontingente zu, um das Reservoir gleichmäßig zu verteilen, basierend auf der Anzahl der Instances, die ausgeführt werden. Das Reservoir-Limit wird gemäß den von Ihnen festgelegten Regeln berechnet. Da die Regeln im Service konfiguriert werden, können Sie die Regeln ohne zusätzliche Bereitstellungen verwalten.

Anmerkung

X-Ray verwendet einen Best-Effort-Ansatz bei der Anwendung von Abtastregeln, und in einigen Fällen stimmt die effektive Abtastrate möglicherweise nicht genau mit den konfigurierten Abtastregeln überein Im Laufe der Zeit sollte die Anzahl der getesteten Anforderungen jedoch in der Nähe des konfigurierten Prozentsatzes liegen.

Sie können jetzt X-Ray-Samplingregeln aus Amazon CloudWatch console. Sie können die X-Ray-Konsole auch weiterhin verwenden.

X-Ray console

So konfigurieren Sie Sampling Regeln in der X-Ray-Konsole

  1. Öffnen SieX-Ray-Konsoleaus.

  2. Klicken Sie aufSamplingim linken Navigationsbereich.

  3. Um eine Regel zu erstellen, wählen Sie Create sampling rule (Samplingregel erstellen) aus.

    Um eine Regel zu bearbeiten, wählen Sie den Namen einer Regel aus.

    Um eine Regel zu löschen, wählen Sie eine Regel aus und verwenden das Menü Actions (Aktionen), um diese zu löschen.

CloudWatch console

So konfigurieren Sie Samplingregeln in CloudWatch Konsole

  1. Melden Sie sich beimAWS Management Consoleund öffnen CloudWatch -Konsolehttps://console.aws.amazon.com/cloudwatch/aus.

  2. Klicken Sie aufEinstellungenim linken Navigationsbereich.

  3. Klicken Sie aufEinstellungen anzeigenunterSamplingregelninnerhalbX-RayAbschnitts erstellt.

  4. Um eine Regel zu erstellen, wählen Sie Create sampling rule (Samplingregel erstellen) aus.

    Um eine Regel zu bearbeiten, wählen Sie eine Regel aus undBearbeitenum es zu bearbeiten.

    Um eine Regel zu löschen, wählen Sie eine Regel aus undLöschenum es zu löschen.

Optionen für Samplingregeln

Für jede Regel stehen folgende Optionen zur Verfügung. Für Zeichenfolgenwerte können Platzhalter verwendet werden, um einem einzelnen Zeichen (?) oder null oder mehreren Zeichen (*) zu entsprechen.

Optionen für Samplingregeln

  • Regelname(Zeichenfolge) — Ein eindeutiger Name für die Regel.

  • Priorität(Ganzzahl zwischen 1 und 9999) — Die Priorität der Samplingregel. Services werten Regeln in aufsteigender Reihenfolge der Priorität aus und treffen eine Sampleentscheidung mit der ersten übereinstimmenden Regel.

  • Reservoir(nicht negative Ganzzahl) — Eine feste Anzahl übereinstimmender Anfragen an das Gerät pro Sekunde vor Anwendung des festen Satzes. Das Reservoir wird nicht direkt von Services verwendet, sondern gilt für alle Services, die die Regel gemeinsam verwenden.

  • Rate(Anzahl zwischen 0 und 100) — Der Prozentsatz der übereinstimmenden Anfragen an das Gerät, nachdem das Reservoir erschöpft ist. Die Rate kann eine ganze Zahl oder ein Gleitkommawert sein.

  • Service name (Servicename)(Servicename) — Der Name des instrumentierten Services in der Service-Übersicht.

    • X-Ray SDK — Der Servicename, den Sie auf dem Recorder konfigurieren.

    • Amazon API Gateway —api-name/stageaus.

  • Service type (Servicetyp)(Servicetyp) — Der Servicetyp, wie er in der Service-Übersicht aufgeführt ist. Für das X-Ring-SDK legen Sie den Servicetyp fest, indem Sie das entsprechende Plugin anwenden:

    • AWS::ElasticBeanstalk::Environment— EinAWS Elastic Beanstalk-Umgebung (Plugin).

    • AWS::EC2::Instance— Eine Amazon EC2 EC2-Instance (Plugin).

    • AWS::ECS::Container— Ein Amazon ECS-Container (Plugin).

    • AWS::APIGateway::Stage— Ein Amazon API Gateway Gateway-Stufe.

    • AWS::AppSync::GraphQLAPI — EinAWS AppSync-API-Anfrage.

  • Host(Zeichenfolge) — Der Hostname aus dem HTTP-Host-Header.

  • HTTP method (HTTP-Methode)(Zeichenfolge) — Die Methode der HTTP-Anforderung.

  • URL path (URL-Pfad)(Zeichenfolge) — Der URL-Pfad der Anforderung.

    • X-Ray SDK — Der Pfadteil der HTTP-Anforderungs-URL.

  • Ressourcen-ARN(string) — Die ARN derAWSressource, die den Dienst ausführt.

    • X-Ray SDK — Nicht unterstützt. Das SDK kann nur Regeln verwenden, bei denen der Ressourcen-ARN auf * festgelegt ist.

    • Amazon API Gateway — Der Stufen-ARN.

  • (Optional)Attribute(Schlüssel und Wert) — Segmentattribute, die bekannt sind, wenn die Samplingentscheidung getroffen wird.

    • X-Ray SDK — Nicht unterstützt. Das SDK ignoriert Regeln, die Attribute angeben.

    • Amazon API Gateway — Header aus der ursprünglichen HTTP-Anforderung.

Beispiele für Samplingregeln

Beispiel — Standardregel ohne Reservoir und einer niedrigen Rate

Sie können das Reservoir und die Rate der Standardregel ändern. Die Standardregel gilt für alle Anforderungen, die nicht mit einer anderen Regel übereinstimmen.

  • Reservoir:0

  • Rate:0.005(0,5 Prozent)

Beispiel — Debugging-Regel zur Nachverfolgung aller Anforderungen für eine problematische Route

Eine Regel mit hoher Priorität, die vorübergehend für das Debuggen angewendet wird.

  • Regelname:DEBUG – history updates

  • Priorität:1

  • Reservoir:1

  • Rate:1

  • Service name (Servicename):Scorekeep

  • Service type (Servicetyp): *

  • Host:*

  • HTTP method (HTTP-Methode):PUT

  • URL path (URL-Pfad):/history/*

  • Ressourcen-ARN:*

Beispiel — Höhere Mindestrate für POSTs

  • Regelname:POST minimum

  • Priorität:100

  • Reservoir:10

  • Rate:0.10

  • Service name (Servicename):*

  • Service type (Servicetyp): *

  • Host:*

  • HTTP method (HTTP-Methode):POST

  • URL path (URL-Pfad):*

  • Ressourcen-ARN:*

Konfigurieren Ihres Service für die Verwendung von Samplingregeln

Das X-Ring-SDK erfordert eine zusätzliche Konfiguration für die Verwendung von Samplingregeln, die Sie in der Konsole konfigurieren. Im Konfigurationsthema finden Sie in Ihrer Sprache Einzelheiten zur Konfiguration einer Samplingstrategie:

Informationen zum API Gateway finden Sie unterUnterstützung von Amazon API Gateway Gateway-Unterstützung fürAWS X-Rayaus.

Anzeigen von Samplingergebnissen

Die X-Ray-KonsoleSamplingzeigt detaillierte Informationen darüber, wie Ihre Dienste die einzelnen Sampling-Regeln verwenden.

Die Spalte Trend zeigt, wie die Regel in den letzten paar Minuten verwendet wurde. Jede Spalte zeigt Statistiken für ein 10-Sekunden-Fenster an.

Samplingstatistiken

  • Total Samplingregeln: Die Anzahl an Anforderungen, die mit dieser Regel übereinstimmen. Diese Zahl umfasst keine Anforderungen, die mit dieser Regel übereingestimmt hätten, aber zuvor mit einer Regel mit höherer Priorität übereingestimmt haben.

  • Total Sampling: Die Anzahl der aufgezeichneten Anforderungen.

  • Mit festem Zinssatz beprobt: Die Anzahl an Anforderungen, die durch die Anwendung der festen Rate der Regel geprüft wurden.

  • Probenahme mit Reservoirlimit: Die Anzahl an Anforderungen, die mit einem von X-Ray-Kontingent geprüft wurden.

  • Vom Reservoir ausgeliehen: Die Anzahl an Anforderungen, die durch das Leihen vom Reservoir geprüft wurden. Wenn ein Service zum ersten Mal eine Übereinstimmung zwischen einer Anfrage und einer Regel feststellt, ist noch keine Kontingentzuteilung durch X-Ray. Wenn jedoch das Reservoir mindestens 1 ist, leiht der Service eine Nachverfolgung pro Sekunde, bis X-Ray ein Kontingent zuweist.

Weitere Informationen zu Samplingstatistiken und dazu, wie Services Samplingregeln verwenden, finden Sie unter Verwenden von Samplingregeln mit der X-Ray-API.

Nächste Schritte

Sie können die X-Ray-Samplingregeln verwalten. Mit der API können Sie Regeln erstellen und aktualisieren, und zwar programmgesteuert nach einem Zeitplan oder als Reaktion auf Alarme oder Benachrichtigungen. Anleitungen und weitere Regelbeispiele finden Sie unter Konfigurieren von Sampling-, Gruppen- und Verschlüsselungseinstellungen mit der AWS X-Ray-API.

Das X-Ray SDKAWS-Services verwenden die X-Röntgen-API auch, um Samplingregeln zu lesen, Samplingergebnisse zu melden und Sampling Services müssen nachverfolgen, wie oft sie jede Regel anwenden, Regeln basierend auf der Priorität bewerten und vom Reservoir leihen, wenn eine Anforderung mit einer Regel übereinstimmt, für die X-Rules dem Service noch kein Kontingent zugewiesen hat. Weitere Informationen dazu, wie ein Service die API für das Sampling verwendet, finden Sie unter Verwenden von Samplingregeln mit der X-Ray-API.

Wenn das X-Ring-SDK Sampling-APIs aufruft, verwendet es den X-Ring-Daemon als Proxy. Wenn Sie TCP-Port 2000 bereits verwenden, können Sie den Daemon so konfigurieren, dass er den Proxy auf einem anderen Port ausführt. Details dazu finden Sie unter Konfigurieren des AWS X-Ray-Daemons.