Konfigurieren von -Samplingregeln

Sie können die AWS X-Ray-Konsole verwenden, um Samplingregeln für Ihre Services zu konfigurieren. Das X-Ray SDK undAWS-Servicesdiese Unterstützungaktives TracingVerwenden Sie bei der Sampling-Konfiguration Stichprobenregeln, um zu bestimmen, welche Anfragen aufgezeichnet werden sollen.

Konfigurieren von -Samplingregeln

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

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

• AWS AppSync—AWS AppSyncunterstützt Probenahme und aktive Rückverfolgung. Um aktives Tracing zu aktivierenAWS AppSyncAnfragen finden Sie unterNachverfolgung mitAWSRöntgen.

• Instrument X-Ray SDK auf Computerplattformen— Bei der Verwendung von Computerplattformen wie Amazon EC2, Amazon ECS oderAWS Elastic Beanstalk, Sampling wird unterstützt, wenn die Anwendung mit dem neuesten X-Ray-SDK instrumentiert wurde.

Anpassen von Samplingregeln

Durch die Anpassung der Stichprobenregeln können Sie die Menge der aufgenommenen Daten steuern. Sie können auch das Sampling-Verhalten ändern, ohne Ihren Code zu ändern oder erneut bereitzustellen. Sampling-Regeln teilen dem X-Ray SDK mit, wie viele Anfragen für eine Reihe von Kriterien aufgezeichnet werden müssen. Standardmäßig zeichnet das X-Ray-SDK jede Sekunde die erste Anfrage und fünf Prozent aller weiteren 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-Ray SDK so konfigurieren, dass es Sampling-Regeln aus einem JSON-Dokument liest, das Sie Ihrem Code hinzufügen. 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. Um lokale Sampling-Regeln zu aktualisieren, müssen Sie Ihren Code außerdem erneut bereitstellen.

Durch die Definition von Sampling-Regeln in der X-Ray-Konsole undKonfiguration des SDKUm Regeln aus dem X-Ray-Dienst zu lesen, können Sie beide 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 Dienst konfiguriert sind, können Sie Regeln verwalten, ohne zusätzliche Implementierungen vornehmen zu müssen.

Anmerkung

X-Ray verwendet bei der Anwendung von Stichprobenregeln einen Best-Effort-Ansatz, und in einigen Fällen entspricht die effektive Abtastrate möglicherweise nicht exakt den konfigurierten Stichprobenregeln. Im Laufe der Zeit sollte die Anzahl der gesampelten Anfragen jedoch in der Nähe des konfigurierten Prozentsatzes liegen.

Sie können jetzt Regeln für die Röntgenprobenahme von Amazon aus konfigurierenCloudWatchKonsole. Sie können die X-Ray-Konsole auch weiterhin verwenden.

CloudWatch console

So konfigurieren Sie Samplingregeln in der CloudWatch-Konsole

1. Melden Sie sich an beiAWS Management Consoleund öffne dasCloudWatchKonsole beihttps://console.aws.amazon.com/cloudwatch/.

2. WähleEinstellungenim linken Navigationsbereich.

3. WählenEinstellungen anzeigenunterRegeln für die Probenahmeinnerhalb derRöntgenspurenAbschnitt.

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 und wählenBearbeitenum es zu bearbeiten.

   Um eine Regel zu löschen, wählen Sie eine Regel und wählenLöschenum es zu löschen.

X-Ray console

Um Sampling-Regeln in der X-Ray-Konsole zu konfigurieren

1. Öffnen Sie dasX-Ray-Konsole.

2. WähleProbenahmeim 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.

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

• Name der Regel(string) — Ein eindeutiger Name für die Regel.

• Priorität(Ganzzahl zwischen 1 und 9999) — Die Priorität der Stichprobenregel. 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 von Abgleichsanfragen an das Instrument pro Sekunde, bevor der feste Tarif angewendet wird. Das Reservoir wird nicht direkt von Services verwendet, sondern gilt für alle Services, die die Regel gemeinsam verwenden.

• Rate(Ganzzahl zwischen 0 und 100) — Der Prozentsatz der übereinstimmenden Anfragen an das Instrument, nachdem das Reservoir aufgebraucht ist. Wählen Sie bei der Konfiguration einer Stichprobenregel in der Konsole einen Prozentsatz zwischen 0 und 100. Geben Sie bei der Konfiguration einer Stichprobenregel in einem Client-SDK mithilfe eines JSON-Dokuments einen Prozentwert zwischen 0 und 1 an.

• Name des Dienstes(Zeichenfolge) — Der Name des instrumentierten Dienstes, wie er in der Service Map angezeigt wird.

  • X-Ray SDK — Der Dienstname, den Sie auf dem Rekorder konfigurieren.

  • Amazon API-Gateway —api-name/stage.

• Art des Dienstes(string) — Der Servicetyp, wie er in der Service Map angezeigt wird. Legen Sie für das X-Ray SDK den Diensttyp fest, indem Sie das entsprechende Plug-in anwenden:

  • AWS::ElasticBeanstalk::Environment— EinAWS Elastic BeanstalkUmgebung (Plugin).

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

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

  • AWS::APIGateway::Stage— Eine Amazon API Gateway-Phase.

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

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

• HTTP-Methode(string) — Die Methode der HTTP-Anfrage.

• URL-Pfad(string) — Der URL-Pfad der Anfrage.

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

• Ressourcen-ARN(string) — Der ARN desAWSRessource, 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 — Die Stufe ARN.

• (Fakultativ)Attribute(Schlüssel und Wert) — Segmentattribute, die zum Zeitpunkt der Stichprobenentscheidung bekannt waren.

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

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

Beispiele für Samplingregeln

Beispiel — Standardregel ohne Reservoir und niedriger 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

• Bewerten:5(0.05wenn mit einem JSON-Dokument konfiguriert)

Beispiel — Debugging-Regel zur Rückverfolgung aller Anfragen für eine problematische Route

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

• Name der Regel:DEBUG – history updates

• Priorität:1

• Stausee:1

• Bewerten:100(1wenn mit einem JSON-Dokument konfiguriert)

• Name des Dienstes:Scorekeep

• Service type (Servicetyp): *

• Gastgeber:*

• HTTP-Methode:PUT

• URL-Pfad:/history/*

• Ressourcen-ARN:*

Beispiel — Höherer Mindestsatz für POSTs

• Name der Regel:POST minimum

• Priorität:100

• Stausee:10

• Bewerten:10(.1wenn mit einem JSON-Dokument konfiguriert)

• Name des Dienstes:*

• Service type (Servicetyp): *

• Gastgeber:*

• HTTP-Methode:POST

• URL-Pfad:*

• Ressourcen-ARN:*

Konfigurieren Ihres Service für die Verwendung von Samplingregeln

Das X-Ray SDK erfordert eine zusätzliche Konfiguration, um Sampling-Regeln verwenden zu können, die Sie in der Konsole konfigurieren. Im Konfigurationsthema finden Sie in Ihrer Sprache Einzelheiten zur Konfiguration einer Samplingstrategie:

• Java: Samplingregeln

• Gehe zu:Samplingregeln

• Node.js:Samplingregeln

• Python: Samplingregeln

• Rubin:Samplingregeln

• .NET:Samplingregeln

Informationen zu API Gateway finden Sie unterUnterstützung für aktives Tracing von Amazon API Gateway fürAWS X-Ray.

Anzeigen von Samplingergebnissen

Die X-Ray-KonsoleProbenahmeAuf dieser Seite finden Sie detaillierte Informationen darüber, wie Ihre Dienste die einzelnen Stichprobenregeln 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

• Gesamtzahl der übereinstimmenden Regeln: Die Anzahl der Anfragen, die dieser Regel entsprachen. Diese Zahl umfasst keine Anforderungen, die mit dieser Regel übereingestimmt hätten, aber zuvor mit einer Regel mit höherer Priorität übereingestimmt haben.

• Gesamtzahl der Stichproben: Die Anzahl der aufgezeichneten Anfragen.

• Mit fester Rate abgetastet: Die Anzahl der Anfragen, bei denen die feste Rate der Regel angewendet wurde.

• Probenahme mit Reservoirlimit: Die Anzahl der Anfragen, die anhand eines von X-Ray zugewiesenen Kontingents abgetastet wurden.

• Aus dem Reservoir geliehen: Die Anzahl der Anfragen, die durch Entleihen aus dem Reservoir abgefragt wurden. Wenn ein Service eine Anfrage zum ersten Mal einer Regel zuordnet, wurde ihm von X-Ray noch kein Kontingent zugewiesen. Wenn das Reservoir jedoch mindestens 1 ist, leiht sich der Service eine Trace pro Sekunde aus, 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-API verwenden, um Probenahmeregeln zu 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 SDK undAWS-Servicesverwenden Sie auch die X-Ray-API, um Probenahmeregeln zu lesen, Probenahmeergebnisse zu melden und Probenahmeziele zu ermitteln. Services müssen verfolgen, wie oft sie die einzelnen Regeln anwenden, Regeln anhand ihrer Priorität bewerten und Daten aus dem Reservoir abrufen, wenn eine Anfrage mit einer Regel übereinstimmt, für die X-Ray 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-Ray-SDK Sampling-APIs aufruft, verwendet es den X-Ray-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.