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.
# Benutze eine Konsole
Verwenden Sie eine Konsole, wenn Sie eine grafische Benutzeroberfläche (GUI) benötigen, die nur wenig Codierung erfordert. Benutzer, die mit X-Ray noch nicht vertraut sind, können mithilfe vorgefertigter Visualisierungen schnell loslegen und grundlegende Aufgaben ausführen. Sie können die folgenden Aktionen direkt von der Konsole aus ausführen:
+ X-Ray aktivieren.
+ Sehen Sie sich allgemeine Zusammenfassungen der Leistung Ihrer Anwendung an.
+ Überprüfen Sie den Status Ihrer Anwendungen.
+ Identifizieren Sie Fehler auf hoher Ebene.
+ Sehen Sie sich grundlegende Trace-Zusammenfassungen an.
Sie können entweder die CloudWatch Amazon-Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)oder die X-Ray-Konsole zu [https://console.aws.amazon.com/xray/Hause](https://console.aws.amazon.com/xray/home) verwenden, um mit X-Ray zu interagieren.
## Verwenden Sie die CloudWatch Amazon-Konsole
Die CloudWatch Konsole enthält neue X-Ray-Funktionen, die gegenüber der X-Ray-Konsole neu gestaltet wurden, um die Bedienung zu vereinfachen. Wenn Sie die CloudWatch Konsole verwenden, können Sie CloudWatch Protokolle und Metriken zusammen mit X-Ray-Trace-Daten anzeigen. Verwenden Sie die CloudWatch Konsole, um Daten wie die folgenden anzuzeigen und zu analysieren:
+ X-Ray-Traces — Sie können die mit Ihrer Anwendung verknüpften Traces anzeigen, analysieren und filtern, während sie eine Anfrage bearbeitet. Verwenden Sie diese Traces, um hohe Latenzen zu finden, Fehler zu debuggen und Ihren Anwendungsworkflow zu optimieren. Sehen Sie sich eine Trace Map und eine Service Map an, um visuelle Darstellungen Ihres Anwendungsworkflows zu sehen.
+ Protokolle — Sie können die von Ihrer Anwendung erstellten Protokolle anzeigen, analysieren und filtern. Verwenden Sie Protokolle, um Fehler zu beheben und die Überwachung auf der Grundlage bestimmter Protokollwerte einzurichten.
+ Metriken — Messen und überwachen Sie die Leistung Ihrer Anwendung anhand von Metriken, die Ihre Ressourcen ausgeben, oder erstellen Sie Ihre eigenen Messwerte. Sehen Sie sich diese Metriken in Grafiken und Diagrammen an.
+ Überwachung von Netzwerken und Infrastruktur — Überwachen Sie wichtige Netzwerke auf Ausfälle und den Zustand und die Leistung Ihrer Infrastruktur, einschließlich containerisierter Anwendungen, anderer AWS Dienste und Clients.
+ Alle Funktionen der X-Ray-Konsole, die im folgenden Abschnitt „**Verwenden Sie die X-Ray-Konsole**“ aufgeführt sind.
Weitere Informationen zur CloudWatch Konsole finden Sie unter [Erste Schritte mit Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/GettingStarted.html).
Loggen Sie sich in die CloudWatch Amazon-Konsole ein unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
## Verwenden Sie die X-Ray-Konsole
Die X-Ray-Konsole bietet verteiltes Tracing für Anwendungsanfragen. Verwenden Sie die X-Ray-Konsole, wenn Sie eine einfachere Konsolenerfahrung wünschen oder Ihren Anwendungscode nicht aktualisieren möchten. AWS entwickelt die X-Ray-Konsole nicht mehr. Die X-Ray-Konsole enthält die folgenden Funktionen für instrumentierte Anwendungen:
+ [Einblicke](xray-console-insights.md) — Erkennen Sie automatisch Anomalien in der Leistung Ihrer Anwendung und finden Sie die zugrunde liegenden Ursachen. **Insights sind in der CloudWatch Konsole unter Insights enthalten.** Weitere Informationen finden Sie unter **Verwenden von X-Ray Insights** in[Verwenden Sie die X-Ray-Konsole](#xray-console).
+ Dienstübersicht — Zeigt eine grafische Struktur Ihrer Anwendung und ihrer Verbindungen zu Clients, Ressourcen, Diensten und Abhängigkeiten an.
+ Ablaufverfolgungen — Sehen Sie sich eine Übersicht der Traces an, die von Ihrer Anwendung bei der Bearbeitung einer Anfrage generiert werden. Verwenden Sie Trace-Daten, um zu verstehen, wie Ihre Anwendung im Vergleich zu grundlegenden Kennzahlen wie HTTP Antwort- und Antwortzeit abschneidet.
+ Analytik — Interpretieren, untersuchen und analysieren Sie Trace-Daten mithilfe von Grafiken zur Verteilung der Antwortzeiten.
+ Konfiguration — Erstellen Sie benutzerdefinierte Traces, um die Standardkonfigurationen für Folgendes zu ändern:
+ Probenahme — Erstellen Sie eine Regel, die festlegt, wie oft Ihre Anwendung nach Trace-Informationen durchsucht werden soll. Weitere Informationen finden Sie unter **Probenahmeregeln konfigurieren** unter[Verwenden Sie die X-Ray-Konsole](#xray-console).
+ [Verschlüsselung](xray-console-encryption.md) — Verschlüsseln Sie Daten im Ruhezustand mit einem Schlüssel, den Sie überprüfen oder deaktivieren können. AWS Key Management Service
+ Gruppen — Verwenden Sie einen Filterausdruck, um eine Gruppe von Traces mit einem gemeinsamen Merkmal wie dem Namen einer URL oder einer Antwortzeit zu definieren. Weitere Informationen finden Sie unter [Gruppen konfigurieren](https://docs.aws.amazon.com/xray/latest/devguide/aws-xray-interface-console.html#xray-console-groups).
Loggen Sie sich zu [https://console.aws.amazon.com/xray/Hause](https://console.aws.amazon.com/xray/home) in die X-Ray-Konsole ein.
## Erkunden Sie die X-Ray-Konsole
Verwenden Sie die X-Ray-Konsole, um eine Übersicht der Dienste und der zugehörigen Traces für Anfragen anzuzeigen, die Ihre Anwendungen bearbeiten, und um Gruppen und Sampling-Regeln zu konfigurieren, die beeinflussen, wie Traces an X-Ray gesendet werden.
**Anmerkung**
Die X-Ray-Service-Karte und die CloudWatch ServiceLens Karte wurden in der CloudWatch Amazon-Konsole zur X-Ray-Trace-Map zusammengefasst. Öffnen Sie die [CloudWatchKonsole](https://console.aws.amazon.com/cloudwatch/) und wählen Sie im linken Navigationsbereich unter **X-Ray-Traces** die Option **Trace Map** aus.
CloudWatch enthält jetzt [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html), mit denen Sie Ihre Anwendungsdienste, Clients, Synthetics-Kanarien und Serviceabhängigkeiten erkennen und überwachen können. Verwenden Sie Application Signals, um eine Liste oder eine visuelle Übersicht Ihrer Services zu erhalten, Integritätskennzahlen auf der Grundlage Ihrer Service-Level-Ziele (SLOs) einzusehen und eine Aufschlüsselung durchzuführen, um korrelierte Röntgenspuren für eine detailliertere Fehlerbehebung zu sehen.
Die primäre X-Ray-Konsolenseite ist die Trace-Map, eine visuelle Darstellung des JSON-Dienstdiagramms, das X-Ray aus den von Ihren Anwendungen generierten Trace-Daten generiert. Die Übersicht besteht aus Service-Knoten für jede Anwendung in Ihrem Konto, das Anforderungen verarbeitet, aus vorgelagerten Knoten, die die Ursprünge der Anforderungen repräsentieren, und aus nachgelagerten Service-Knoten, die Web-Services und Ressourcen darstellen, die von einer Anwendung während der Verarbeitung einer Anforderung verwendet werden. Es gibt zusätzliche Seiten zum Anzeigen von Traces und Trace-Details sowie zum Konfigurieren von Gruppen und Stichprobenregeln.
Sehen Sie sich das Konsolenerlebnis für X-Ray an und vergleichen Sie es mit der CloudWatch Konsole in den folgenden Abschnitten.
**Topics**
+ [Verwenden Sie die CloudWatch Amazon-Konsole](#aws-xray-interface-console-cw)
+ [Verwenden Sie die X-Ray-Konsole](#xray-console)
+ [Erkunden Sie die X-Ray-Konsole](#xray-console-explore)
+ [Verwenden der X-Ray-Trace-Map](xray-console-servicemap.md)
+ [Traces und Trace-Details anzeigen](xray-console-traces.md)
+ [Verwenden von Filterausdrücken](xray-console-filters.md)
+ [Kontenübergreifende Rückverfolgung](xray-console-crossaccount.md)
+ [Nachverfolgung ereignisgesteuerter Anwendungen](xray-tracelinking.md)
+ [Verwendung von Latenzhistogrammen](xray-console-histograms.md)
+ [Nutzung von X-Ray Insights](xray-console-insights.md)
+ [Interaktion mit der -Analysekonsole](xray-console-analytics.md)
+ [Gruppen konfigurieren](xray-console-groups.md)
+ [Konfigurieren von -Samplingregeln](xray-console-sampling.md)
+ [Konfiguration der adaptiven Probenahme](xray-adaptive-sampling.md)
+ [Deep Linking für Konsolen](xray-console-deeplinks.md)
# Verwenden der X-Ray-Trace-Map
Sehen Sie sich die X-Ray-Trace-Map an, um Dienste zu identifizieren, bei denen Fehler auftreten, Verbindungen mit hoher Latenz oder Traces für Anfragen, die nicht erfolgreich waren.
**Anmerkung**
CloudWatch enthält jetzt [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html), mit denen Sie Ihre Anwendungsservices, Clients, synthetischen Datenbanken und Dienstabhängigkeiten erkennen und überwachen können. Verwenden Sie Application Signals, um eine Liste oder eine visuelle Übersicht Ihrer Services zu erhalten, Integritätskennzahlen auf der Grundlage Ihrer Service-Level-Ziele (SLOs) einzusehen und eine Aufschlüsselung durchzuführen, um korrelierte Röntgenspuren für eine detailliertere Fehlerbehebung zu sehen.
Die X-Ray-Servicekarte und die CloudWatch ServiceLens Karte werden in der CloudWatch Amazon-Konsole zur X-Ray-Trace-Map kombiniert. Öffnen Sie die [CloudWatch Konsole](https://console.aws.amazon.com/cloudwatch/) und wählen Sie im linken Navigationsbereich unter **X-Ray-Traces** die Option **Trace Map** aus.
## Anzeigen der Ablaufverfolgungskarte
Die Trace-Map ist eine visuelle Darstellung der Trace-Daten, die von Ihren Anwendungen generiert werden. Die Karte zeigt Dienstknoten, die Anfragen bearbeiten, vorgelagerte Clientknoten, die den Ursprung der Anfragen darstellen, und Downstream-Serviceknoten, die Webdienste und Ressourcen darstellen, die von einer Anwendung bei der Bearbeitung einer Anfrage verwendet werden.
Die Trace-Map zeigt eine verknüpfte Ansicht von Traces für ereignisgesteuerte Anwendungen, die Amazon SQS und Lambda verwenden. [Weitere Informationen finden Sie unter Ablaufverfolgung ereignisgesteuerter Anwendungen.](xray-tracelinking.md) Die Trace-Map unterstützt auch die [kontenübergreifende Ablaufverfolgung, sodass](xray-console-crossaccount.md) Knoten aus mehreren Konten in einer einzigen Map angezeigt werden.
------
#### [ CloudWatch console ]
**Um die Trace-Map in der Konsole anzuzeigen CloudWatch**
1. Öffnen Sie die [CloudWatch -Konsole](https://console.aws.amazon.com/cloudwatch/). Wählen Sie im linken Navigationsbereich im Bereich **X-Ray Traces** die Option **Trace Map** aus.
![\[CloudWatch Trace-Map-Seite für die Konsole\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-servicemap-cw.png)
1. Wählen Sie einen Service-Knoten, um Anforderungen für diesen Knoten anzuzeigen, oder eine Edge zwischen zwei Knoten, um Anforderungen anzuzeigen, die diese Verbindung passiert haben.
1. Unter der Trace-Map werden zusätzliche Informationen angezeigt, darunter Registerkarten für Messwerte, Warnmeldungen und die Verteilung der Antwortzeiten. Wählen Sie auf der Registerkarte **Metriken** einen Bereich innerhalb jedes Diagramms aus, um weitere Details anzuzeigen, oder wählen Sie die Optionen **Fehler** oder **Fehler**, um die Ablaufverfolgung zu filtern. Wählen Sie auf der Registerkarte **Verteilung der Antwortzeiten** einen Bereich innerhalb des Diagramms aus, um die Ablaufverfolgung nach Antwortzeit zu filtern.
![\[Dashboard showing latency, requests, and faults metrics for an ElasticBeanstalk environment.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-cw-servicemap-node-detail.png)
1. Zeigen Sie Traces an, indem Sie **Traces anzeigen** wählen, oder wenn ein Filter angewendet wurde, wählen Sie **Gefilterte Traces anzeigen**.
1. Wählen Sie **Protokolle anzeigen**, um die mit dem ausgewählten Knoten verknüpften CloudWatch Protokolle anzuzeigen. Nicht alle Trace-Map-Knoten unterstützen das Anzeigen von Protokollen. Weitere Informationen finden Sie in den [ CloudWatch Protokollen zur Fehlerbehebung](xray-troubleshooting.md#xray-troubleshooting-Nologs).
In der Trace-Map werden Probleme innerhalb der einzelnen Knoten farblich dargestellt:
+ **Rot** für Server-Fehler (500er-Fehler)
+ **Gelb** für Client-Fehler (400er-Fehler)
+ **Violett** für Ablehnungsfehler („Fehler 429 – Zu viele Anfragen”)
Wenn Ihre Trace-Map groß ist, verwenden Sie die Steuerelemente auf dem Bildschirm oder die Maus, um sie zu vergrößern und zu verkleinern und die Karte zu verschieben.
------
#### [ X-Ray console ]
**Um die Serviceübersicht anzuzeigen**
1. Öffnen Sie die [X-Ray-Konsole](https://console.aws.amazon.com/xray/home#). Die Serviceübersicht wird standardmäßig angezeigt. Sie können **Service Map** auch im linken Navigationsbereich auswählen.
![\[Service-Map-Seite für die X-Ray-Konsole\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-servicemap-xray.png)
1. Wählen Sie einen Service-Knoten, um Anforderungen für diesen Knoten anzuzeigen, oder eine Edge zwischen zwei Knoten, um Anforderungen anzuzeigen, die diese Verbindung passiert haben.
1. Verwenden Sie das [Histogramm](xray-console-histograms.md) der Antwortverteilung, um Traces nach Dauer zu filtern, und wählen Sie die Statuscodes aus, für die Sie Traces anzeigen möchten. Klicken Sie anschließend auf **View traces**, um die Ablaufverfolgungsliste mit angewendetem Filterausdruck zu öffnen.
![\[Response distribution graph showing latency peaks and service details for Scorekeep AWS ECS container.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-servicemap-nodedetail-xray.png)
Die Service-Karte zeigt den Zustand jedes Knotens an und markiert ihn farblich auf Grundlage des Verhältnisses zwischen erfolgreichen Anrufen und Fehlern:
+ **Grün** für erfolgreiche Anrufe
+ **Rot** für Server-Fehler (500er-Fehler)
+ **Gelb** für Client-Fehler (400er-Fehler)
+ **Violett** für Ablehnungsfehler („Fehler 429 – Zu viele Anfragen”)
Wenn Ihre Service-Map groß ist, können Sie die Karte mithilfe der Steuerelemente auf dem Bildschirm oder mit der Maus vergrößern und verkleinern und verschieben.
------
**Anmerkung**
Die X-Ray-Trace-Map kann bis zu 10.000 Knoten anzeigen. In seltenen Fällen, in denen die Gesamtzahl der Serviceknoten diesen Grenzwert überschreitet, kann es vorkommen, dass Sie eine Fehlermeldung erhalten und keine vollständige Trace-Map in der Konsole anzeigen können.
## Die Trace-Map nach Gruppen filtern
Mithilfe eines [Filterausdrucks](xray-console-filters.md) können Sie Kriterien definieren, anhand derer Traces in eine Gruppe aufgenommen werden sollen. Gehen Sie wie folgt vor, um diese spezifische Gruppe dann in der Trace-Map anzuzeigen.
------
#### [ CloudWatch console ]
Wählen Sie einen Gruppennamen aus dem Gruppenfilter oben links auf der Trace-Map aus.
![\[Search bar for filtering by X-Ray group, with "TestGroup" displayed as an option.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-servicemap-groups-cw.png)
------
#### [ X-Ray console ]
Wählen Sie einen Gruppennamen aus dem Dropdown-Menü links neben der Suchleiste aus.
![\[Drop-down menu showing Default, TestGroup, Create group, and Learn more options.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/group-select-console.png)
------
Die Service-Map wird nun so gefiltert, dass Traces angezeigt werden, die dem Filterausdruck der ausgewählten Gruppe entsprechen.
## Legende und Optionen der Trace-Map
Die Trace-Map enthält eine Legende und mehrere Optionen zum Anpassen der Kartenanzeige.
------
#### [ CloudWatch console ]
Wählen Sie oben rechts auf der Karte das Drop-down-Menü **Legende und Optionen** aus. Wählen Sie aus, was in den Knoten angezeigt wird, darunter:
+ **Metrics** zeigt die durchschnittliche Antwortzeit und die Anzahl der pro Minute während des ausgewählten Zeitraums gesendeten Traces an.
+ **Nodes** zeigt das Dienstsymbol in jedem Knoten an.
Wählen Sie zusätzliche Karteneinstellungen aus dem Bereich **Einstellungen** aus, auf den Sie über das Zahnradsymbol oben rechts in der Karte zugreifen können. Zu diesen Einstellungen gehört die Auswahl, anhand welcher Metrik die Größe der einzelnen Knoten bestimmt wird und welche Kanarienvögel auf der Karte angezeigt werden sollen.
------
#### [ X-Ray console ]
Zeigen Sie die Legende der Servicekarte an, indem Sie oben rechts auf der **Karte auf den Link Kartenlegende** klicken. Unten rechts auf der Trace-Map können Optionen für die Servicekarte ausgewählt werden, darunter:
+ Mit den **Dienstsymbolen** wird umgeschaltet, was innerhalb der einzelnen Knoten angezeigt wird. Dabei wird entweder das Servicesymbol oder die durchschnittliche Antwortzeit und die Anzahl der pro Minute während des ausgewählten Zeitraums gesendeten Traces angezeigt.
+ **Knotengröße: Bei „Keine**“ werden alle Knoten auf dieselbe Größe gesetzt.
+ **Knotengröße: Health** bewertet Knoten anhand der Anzahl der betroffenen Anfragen, einschließlich Fehlern, Störungen oder gedrosselten Anfragen.
+ **Knotengröße: Der Traffic berechnet** die Größe der Knoten anhand der Gesamtzahl der Anfragen.
------
# Traces und Trace-Details anzeigen
Verwenden Sie die Seite „**Traces**“ in der X-Ray-Konsole, um Traces anhand von URL, Antwortcode oder anderen Daten aus der Trace-Zusammenfassung zu suchen. Nachdem Sie einen Trace aus der Trace-Liste ausgewählt haben, zeigt die Seite mit den **Trace-Details** eine Übersicht der Service-Knoten, die dem ausgewählten Trace zugeordnet sind, sowie eine Zeitleiste mit Trace-Segmenten.
## Anzeigen von Ablaufverfolgungen
------
#### [ CloudWatch console ]
**Um Traces in der CloudWatch Konsole anzuzeigen**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Wählen Sie im linken Navigationsbereich **X-Ray Traces** und dann **Traces** aus. Sie können nach Gruppen filtern oder einen [Filterausdruck](xray-console-filters.md) eingeben. Dadurch werden die Spuren gefiltert, die im Abschnitt „**Spuren**“ unten auf der Seite angezeigt werden.
Alternativ können Sie die Service-Map verwenden, um zu einem bestimmten Serviceknoten zu navigieren und sich dann die Traces anzusehen. Dadurch wird die Seite „**Traces**“ geöffnet, auf der bereits eine Abfrage angewendet wurde.
1. Verfeinern Sie Ihre Abfrage im Bereich **Abfrageverfeinerungen**. Um Traces nach einem gemeinsamen Attribut zu filtern, wählen Sie eine Option aus dem Abwärtspfeil neben **Abfrage verfeinern nach**. Es gibt die folgenden Optionen:
+ Knoten — Filtert Traces nach Dienstknoten.
+ Ressourcen-ARN — Filtert Traces nach einer Ressource, die einer Ablaufverfolgung zugeordnet ist. Beispiele für diese Ressourcen sind eine Amazon Elastic Compute Cloud (Amazon EC2) -Instance, eine AWS Lambda Funktion oder eine Amazon DynamoDB Tabelle.
+ Benutzer — Filtert Traces mit einer Benutzer-ID.
+ Meldung zur Fehlerursache — Filtert die Ablaufverfolgung nach der Fehlerursache.
+ URL — Filtert Traces nach einem URL-Pfad, der von Ihrer Anwendung verwendet wird.
+ HTTP-Statuscode — Filtert Traces nach dem von Ihrer Anwendung zurückgegebenen HTTP-Statuscode. Sie können einen benutzerdefinierten Antwortcode angeben oder aus den folgenden Optionen wählen:
+ `200`— Die Anfrage war erfolgreich.
+ `401`— Der Anfrage fehlten gültige Authentifizierungsdaten.
+ `403`— Der Anfrage fehlten gültige Berechtigungen.
+ `404`— Der Server konnte die angeforderte Ressource nicht finden.
+ `500`— Der Server ist auf einen unerwarteten Fehler gestoßen und hat einen internen Fehler generiert.
Wählen Sie einen oder mehrere Einträge aus und klicken Sie dann **auf Zur Abfrage** hinzufügen, um den Filterausdruck oben auf der Seite zu ergänzen.
1. Um einen einzelnen Trace zu finden, geben Sie eine [Trace-ID](xray-api-sendingdata.md#xray-api-traceids) direkt in das Abfragefeld ein. Sie können das X-Ray-Format oder das World Wide Web Consortium (W3C) -Format verwenden. Ein Trace, der mit dem [AWS Distro for](xray-instrumenting-your-app.md#xray-instrumenting-opentel) erstellt wurde, hat beispielsweise das OpenTelemetry W3C-Format.
**Anmerkung**
Wenn Sie Traces abfragen, die mit einer Trace-ID im W3C-Format erstellt wurden, zeigt die Konsole die entsprechende Ablaufverfolgung im X-Ray-Format an. Wenn Sie beispielsweise `4efaaf4d1e8720b39541901950019ee5` im W3C-Format abfragen, zeigt die Konsole das X-Ray-Äquivalent an:`1-4efaaf4d-1e8720b39541901950019ee5`.
1. Wählen Sie „**Abfrage jederzeit ausführen**“, um im Bereich „Traces“ unten auf der Seite eine Liste der passenden **Traces** anzuzeigen.
1. Um die Seite mit den **Trace-Details** für einen einzelnen Trace anzuzeigen, wählen Sie eine Trace-ID aus der Liste aus.
Die folgende Abbildung zeigt eine **Trace-Map** mit Serviceknoten, die mit der Trace verknüpft sind, und Kanten zwischen den Knoten, die den Pfad der Segmente, aus denen sich die Trace zusammensetzt, darstellen. Auf die ****Trace-Map folgt eine Trace-Zusammenfassung****. Die Zusammenfassung enthält Informationen über einen `GET` Beispielvorgang, seinen **Antwortcode**, die **Dauer** der Ausführung der Ablaufverfolgung und das **Alter** der Anfrage. Die **Segment-Timeline** folgt der **Trace-Zusammenfassung**, in der die Dauer der Trace-Segmente und -Untersegmente angezeigt wird.
![\[Eine Trace-Map, eine Zusammenfassung und eine Segment-Timeline enthalten detaillierte Informationen zu den Serviceknoten und den Segmenten im Trace.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/xray-trace-details-cw.png)
**Wenn Sie über eine ereignisgesteuerte Anwendung verfügen, die Amazon SQS und Lambda verwendet, können Sie in der Trace-Map eine verknüpfte Ansicht der Traces für jede Anfrage sehen.** In der Karte werden die Spuren von Nachrichtenerstellern mit den Spuren von AWS Lambda Verbrauchern verknüpft und als gestrichelte Linie dargestellt. Weitere Informationen zu ereignisgesteuerten Anwendungen finden Sie unter. [Nachverfolgung ereignisgesteuerter Anwendungen](xray-tracelinking.md)
Die Seiten **Traces** und **Trace-Details** unterstützen auch die [kontenübergreifende Ablaufverfolgung](xray-console-crossaccount.md), bei der Traces von mehreren Konten in der Trace-Liste und in einer einzigen Trace-Map aufgeführt werden können.
------
#### [ X-Ray console ]
**So zeigen Sie Spuren in der X-Ray-Konsole an**
1. Öffnen Sie die [Traces-Seite](https://console.aws.amazon.com/xray/home#/traces) in der X-Ray-Konsole. Im Bereich **Trace-Übersicht** wird eine Liste von Traces angezeigt, die nach gemeinsamen Merkmalen wie **Fehlerursachen**, **ResourceARN** und **InstanceId**gruppiert sind.
1. Um ein allgemeines Merkmal auszuwählen, um einen gruppierten Satz von Traces anzuzeigen, erweitern Sie den Abwärtspfeil neben **Gruppieren nach**. Die folgende Abbildung zeigt eine Trace-Übersicht der Traces, die nach der URL für gruppiert sind[AWS X-Ray Musteranwendung](xray-scorekeep.md), sowie eine Liste der zugehörigen Traces.
![\[Beispiel für eine Trace-Übersicht, gruppiert nach URL, gefolgt von einer Trace-Liste mit Details wie ID, Methode und Antwort.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/scorekeep-traces.png)
1. Wählen Sie die **ID** einer Ablaufverfolgung aus, um sie unter der **Trace-Liste** anzuzeigen. Sie können auch im Navigationsbereich die Option **Service Map** auswählen, um die Traces für einen bestimmten Serviceknoten anzuzeigen. Anschließend können Sie die mit diesem Knoten verknüpften Traces anzeigen.
Auf der Registerkarte **Zeitleiste** wird der Anforderungsablauf für den Trace angezeigt. Er umfasst Folgendes:
+ Eine Karte des Pfads für jedes Segment im Trace.
+ Wie lange es gedauert hat, bis das Segment einen Knoten in der Trace-Map erreicht hat.
+ Wie viele Anfragen wurden an den Knoten in der Trace-Map gestellt.
Die folgende Abbildung zeigt ein Beispiel für eine **Trace-Map**, die mit einer `GET` Anforderung verknüpft ist, die an eine Beispielanwendung gestellt wurde. Die Pfeile zeigen den Pfad, den jedes Segment zurückgelegt hat, um die Anfrage abzuschließen. Die Dienstknoten zeigen die Anzahl der Anfragen an, die während der `GET` Anfrage gestellt wurden.
![\[Ablaufplan, gefolgt von einer Zeitleiste mit Segmenten, deren Dauer, Ursprung und Ende im Verhältnis zueinander.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/xray-trace-details.png)
Weitere Informationen zur Registerkarte „**Zeitleiste**“ finden Sie im folgenden Abschnitt „**Überblick über die Ablaufverfolgung**“.
Auf der Registerkarte **Rohdaten werden** Informationen über die Spur und die Segmente und Untersegmente, aus denen sich die Spur zusammensetzt, im `JSON` Format angezeigt. Diese Informationen können Folgendes beinhalten:
+ Zeitstempel
+ Einzigartig IDs
+ Dem Segment oder Untersegment zugeordnete Ressourcen
+ Die Quelle oder der Ursprung des Segments oder Untersegments
+ Zusätzliche Informationen über die Anfrage an Ihre Anwendung, z. B. die Antwort auf eine HTTP-Anfrage
------
## Erkunden Sie den Trace-Zeitplan
Der Abschnitt **Zeitleiste** zeigt eine Hierarchie von Segmenten und Untersegmenten neben einem horizontalen Balken, der der Zeit entspricht, die sie für die Erledigung ihrer Aufgaben aufgewendet haben. Der erste Eintrag in der Liste ist das Segment, das alle vom Service für eine einzelne Anforderung aufgezeichneten Daten darstellt. Untersegmente sind eingerückt und werden im Anschluss an das Segment aufgelistet. Spalten enthalten Informationen zu den einzelnen Segmenten.
------
#### [ CloudWatch console ]
In der CloudWatch Konsole bietet die **Segment-Timeline** die folgenden Informationen:
+ Die erste Spalte: Listet die Segmente und Untersegmente in der ausgewählten Spur auf.
+ Die Spalte **Segmentstatus**: Listet das Statusergebnis jedes Segments und Untersegments auf.
+ Die Spalte **Antwortcode**: Listet einen HTTP-Antwortstatuscode auf eine Browseranfrage auf, die von dem Segment oder Untersegment gestellt wurde, sofern verfügbar.
+ Die Spalte **Dauer**: Listet auf, wie lange das Segment oder Untersegment lief.
+ Die Spalte **Gehostet in**: Listet den Namespace oder die Umgebung auf, in der das Segment oder Untersegment ausgeführt wird, falls zutreffend. Weitere Informationen finden Sie unter [Gesammelte Dimensionen und Dimensionskombinationen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AppSignals-StandardMetrics.html#AppSignals-StandardMetrics-Dimensions).
+ Die letzte Spalte: Zeigt horizontale Balken an, die der Dauer entsprechen, in der das Segment oder Untersegment im Verhältnis zu den anderen Segmenten oder Untersegmenten in der Zeitleiste ausgeführt wurde.
Um die Liste der Segmente und Untersegmente nach Serviceknoten zu gruppieren, aktivieren Sie die Option Nach Knoten **gruppieren**.
------
#### [ X-Ray console ]
Wählen Sie auf der Seite mit den Trace-Details die Registerkarte **Timeline** aus, um die Timeline für jedes Segment und Untersegment anzuzeigen, aus denen ein Trace besteht.
In der X-Ray-Konsole bietet die **Timeline** die folgenden Informationen:
+ Die Spalte **Name**: Listet die Namen der Segmente und Untersegmente im Trace auf.
+ Die Spalte **Res.**: Listet einen HTTP-Antwortstatuscode auf eine Browseranfrage auf, die von dem Segment oder Untersegment gestellt wurde, sofern verfügbar.
+ Die Spalte **Dauer**: Listet auf, wie lange das Segment oder Untersegment lief.
+ Die Spalte **Status**: Listet das Ergebnis des Status eines Segments oder Untersegments auf.
+ Die letzte Spalte: Zeigt horizontale Balken an, die der Dauer entsprechen, in der das Segment oder Untersegment im Verhältnis zu den anderen Segmenten oder Untersegmenten in der Zeitleiste ausgeführt wurde.
Um die rohen Trace-Daten anzuzeigen, die die Konsole zur Generierung der Zeitleiste verwendet, wählen Sie die Registerkarte **Rohdaten**. Die Rohdaten zeigen Ihnen Informationen über den Trace und die Segmente und Untersegmente, aus denen sich der Trace zusammensetzt, im `JSON` Format. Diese Informationen können Folgendes beinhalten:
+ Zeitstempel
+ Einzigartig IDs
+ Dem Segment oder Untersegment zugeordnete Ressourcen
+ Die Quelle oder der Ursprung des Segments oder Untersegments
+ Zusätzliche Informationen über die Anfrage an Ihre Anwendung, z. B. die Antwort auf eine HTTP-Anfrage.
------
Wenn Sie ein instrumentiertes AWS SDK verwenden, HTTP, oder SQL Client für Aufrufe externer Ressourcen, das X-Ray SDK zeichnet Untersegmente automatisch auf. Sie können das X-Ray SDK auch verwenden, um benutzerdefinierte Untersegmente für jede Funktion oder jeden Codeblock aufzuzeichnen. Zusätzliche Untersegmente, die aufgezeichnet werden, während ein benutzerdefiniertes Untersegment geöffnet ist, werden zu untergeordneten Segmenten des benutzerdefinierten Untersegments.
## Anzeigen von Segmentdetails
Wählen Sie in der **Trace-Zeitleiste** den Namen eines Segments aus, um dessen Details anzuzeigen.
Im **Bereich „Segmentdetails**“ werden die Registerkarten „**Übersicht**“, „**Ressourcen**“, „**Anmerkungen**“, „**Metadaten**“, „**Ausnahmen**“ und „**SQL**“ angezeigt. Es gelten die folgenden Bedingungen:
+ Die Registerkarte **Overview (Übersicht)** zeigt Informationen zu Anforderung und Antwort an. Zu den Informationen gehören der Name, die Startzeit, die Endzeit, die Anforderungs-URL, der Anforderungsvorgang, der Anforderungsantwortcode sowie etwaige Fehler und Störungen.
+ Auf der Registerkarte **Ressourcen** für ein Segment werden Informationen aus dem X-Ray SDK und zu den AWS Ressourcen angezeigt, auf denen Ihre Anwendung ausgeführt wird. Verwenden Sie die Amazon EC2 - AWS Elastic Beanstalk oder Amazon ECS-Plug-ins für das X-Ray SDK, um servicespezifische Ressourceninformationen aufzuzeichnen. Weitere Informationen zu Plug-ins finden Sie im [Konfiguration des X-Ray SDK for Java](xray-sdk-java-configuration.md) Abschnitt **Service-Plugins** unter.
+ Auf den verbleibenden Registerkarten werden **Anmerkungen**, **Metadaten** und **Ausnahmen** angezeigt, die für das Segment aufgezeichnet wurden. Ausnahmen werden automatisch erfasst, wenn sie aus einer instrumentierten Anfrage generiert werden. Anmerkungen und Metadaten enthalten zusätzliche Informationen, die Sie mithilfe der vom X-Ray SDK bereitgestellten Operationen aufzeichnen. Verwenden Sie das X-Ray SDK, um Anmerkungen oder Metadaten zu Ihren Segmenten hinzuzufügen. Weitere Informationen finden Sie unter dem sprachspezifischen Link, der unter Instrumentierung Ihrer Anwendung mit in aufgeführt ist. AWS X-Ray SDKs [Instrumentierung Ihrer Anwendung für AWS X-Ray](xray-instrumenting-your-app.md)
## Anzeigen von Untersegmentdetails
Wählen Sie in der Ablaufverfolgungszeitleiste den Namen eines Untersegments aus, um dessen Details anzuzeigen:
+ Die Registerkarte „**Übersicht**“ enthält Informationen über die Anfrage und die Antwort. Dazu gehören der Name, die Startzeit, die Endzeit, die Dauer und die Anfrage URL, Vorgang der Anfrage, Antwortcode der Anfrage und etwaige Fehler und Störungen. Für die mit instrumentierten Clients generierten Untersegmente enthält die Registerkarte **Overview (Übersicht)** Informationen zu Anforderung und Antwort aus der Sicht Ihrer Anwendung.
+ Auf der Registerkarte **Ressourcen** für ein Untersegment werden Details zu den AWS Ressourcen angezeigt, die zur Ausführung des Untersegments verwendet wurden. Die Registerkarte Ressourcen kann beispielsweise einen AWS Lambda Funktions-ARN, Informationen über eine DynamoDB-Tabelle, jede aufgerufene Operation und eine Anforderungs-ID enthalten.
+ Auf den verbleibenden Registerkarten werden **Anmerkungen**, **Metadaten** und **Ausnahmen angezeigt, die für das Untersegment** aufgezeichnet wurden. Ausnahmen werden automatisch erfasst, wenn sie aus einer instrumentierten Anfrage generiert werden. Anmerkungen und Metadaten enthalten zusätzliche Informationen, die Sie mithilfe der vom X-Ray SDK bereitgestellten Operationen aufzeichnen. Verwenden Sie das X-Ray SDK, um Anmerkungen oder Metadaten zu Ihren Segmenten hinzuzufügen. Weitere Informationen finden Sie unter dem sprachspezifischen Link, der unter **Instrumentierung Ihrer** Anwendung mit in aufgeführt ist. AWS X-Ray SDKs [Instrumentierung Ihrer Anwendung für AWS X-Ray](xray-instrumenting-your-app.md)
Bei benutzerdefinierten Untersegmenten zeigt die Registerkarte **Overview (Übersicht)** den Namen des Untersegments an, den Sie angeben können, um den Code-Bereich oder die Funktion anzugeben, der oder die aufgezeichnet wird. Weitere Informationen finden Sie unter dem sprachspezifischen Link, der unter **Instrumentierung** Ihrer Anwendung mit in aufgeführt ist. AWS X-Ray SDKs [Generieren von benutzerdefinierten Untersegmenten mit dem X-Ray SDK for Java](xray-sdk-java-subsegments.md)
Die folgende Abbildung zeigt die Registerkarte „**Übersicht**“ für ein benutzerdefiniertes Untersegment. Die Übersicht enthält die Untersegment-ID, die übergeordnete ID, den Namen, die Start- und Endzeiten, die Dauer, den Status und die Fehler oder Störungen.
![\[Übersichtsinformationen zu einem Untersegment, einschließlich ID, übergeordneter ID, Name, Uhrzeiten, Fehlern und Störungen.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/scorekeep-PUTrules-customsubsegment-overview.png)
Die Registerkarte „**Metadaten**“ für ein benutzerdefiniertes Untersegment enthält Informationen in JSON Format über die Ressourcen, die von diesem Untersegment verwendet werden.
# Verwenden von Filterausdrücken
Verwenden Sie *Filterausdrücke*, um eine Trace-Map oder Traces für eine bestimmte Anfrage, einen bestimmten Dienst, eine Verbindung zwischen zwei Diensten (ein Edge) oder Anfragen, die eine Bedingung erfüllen, anzuzeigen. X-Ray bietet eine Sprache für Filterausdrücke zum Filtern von Anfragen, Diensten und Kanten auf der Grundlage von Daten in Anforderungsheadern, Antwortstatus und indizierten Feldern in den ursprünglichen Segmenten.
Wenn Sie einen Zeitraum für die Anzeige von Traces in der X-Ray-Konsole auswählen, erhalten Sie möglicherweise mehr Ergebnisse, als die Konsole anzeigen kann. In der rechten oberen Ecke der Konsole wird die Anzahl der gescannten Ablaufverfolgungen angezeigt und Sie können ablesen, ob weitere Ablaufverfolgungen verfügbar sind. Sie können einen Filterausdruck verwenden, um die Ergebnisse auf die Spuren einzugrenzen, nach denen Sie suchen möchten.
**Topics**
+ [Details zu Filterausdrücken](#xray-console-filters-details)
+ [Verwenden von Filterausdrücken mit Gruppen](#groups)
+ [Syntax für Filterausdrücke](#console-filters-syntax)
+ [Boolesche Schlüsselwörter](#console-filters-boolean)
+ [Zahlenschlüsselwörter](#console-filters-number)
+ [Zeichenfolgen-Schlüsselwörter](#console-filters-string)
+ [Komplexe Schlüsselwörter](#console-filters-complex)
+ [id-Funktion](#console-filters-functions)
## Details zu Filterausdrücken
Wenn Sie [einen Knoten in der Trace-Map auswählen](xray-console-servicemap.md), erstellt die Konsole einen Filterausdruck, der auf dem Dienstnamen des Knotens und den auf Ihrer Auswahl beruhenden Fehlertypen basiert. Um Ablaufverfolgungen zu finden, die Leistungsprobleme zeigen oder zu bestimmten Anfragen gehören, können Sie den von der Konsole bereitgestellten Ausdruck anpassen oder einen eigenen erstellen. Wenn Sie Anmerkungen mit dem X-Ray SDK hinzufügen, können Sie auch nach dem Vorhandensein eines Annotationsschlüssels oder dem Wert eines Schlüssels filtern.
**Anmerkung**
Wenn Sie in der Trace-Map einen relativen Zeitraum und einen Knoten auswählen, konvertiert die Konsole den Zeitraum in eine absolute Start- und Endzeit. Um sicherzustellen, dass die Ablaufverfolgungen für den Knoten in den Suchergebnissen angezeigt werden, und um das Scannen von Zeiträumen zu vermeiden, in denen der Knoten nicht aktiv war, werden nur Zeiten in den Zeitraum einbezogen, zu denen der Knoten Ablaufverfolgungen gesendet hat. Um relativ zur aktuellen Zeit zu suchen, können Sie wieder zum relativen Zeitraum auf der Seite der Ablaufverfolgungen wechseln und einen erneuten Scan durchführen.
Wenn immer noch mehr Ergebnisse vorliegen, als in der Konsole angezeigt werden können, gibt die Konsole die Anzahl der Ablaufverfolgungen an, die die Kriterien erfüllt haben, sowie die Anzahl der gescannten Ablaufverfolgungen. Der angezeigte Prozentsatz entspricht dem Prozentsatz des ausgewählten Zeitraums, der gescannt wurde. Um sicherzustellen, dass alle passenden Ablaufverfolgungen in den Ergebnissen angezeigt werden, grenzen Sie Ihren Filterausdruck weiter ein oder wählen einen kürzeren Zeitraum aus.
Die Konsole beginnt den Scan am Ende des Zeitraums und arbeitet sich nach vorne durch, um Ihnen die aktuellsten Ergebnisse zuerst anzuzeigen. Wenn viele Ablaufverfolgungen vorliegen, aber nur wenige Ergebnisse, teilt die Konsole den Zeitraum in Abschnitte ein und scannt diese parallel. Der Fortschrittsbalken zeigt die Abschnitte des Zeitraums an, die gescannt wurden.
![\[Progress bar showing 52% of time range scanned, with 49 matching traces found.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-tracescan-parallel.png)
## Verwenden von Filterausdrücken mit Gruppen
Gruppen sind eine Sammlung von Traces, die durch einen Filterausdruck definiert sind. Sie können Gruppen verwenden, um zusätzliche Servicegraphen zu erstellen und CloudWatch Amazon-Metriken bereitzustellen.
Gruppen werden über ihren Namen oder einen Amazon-Ressourcennamen (ARN) identifiziert und enthalten einen Filterausdruck. Der Service vergleicht eingehende Ablaufverfolgungen mit dem Ausdruck und speichert sie entsprechend.
Sie können Gruppen mit dem Dropdown-Menü links neben der Suchleiste des Filterausdrucks erstellen und ändern.
**Anmerkung**
Wenn der Service einen Fehler beim Qualifizieren einer Gruppe feststellt, ist diese Gruppe nicht mehr in der Verarbeitung eingehender Ablaufverfolgungen enthalten und es wird eine Fehlermetrik aufgezeichnet.
Weitere Informationen zu Gruppen finden Sie unter[Gruppen konfigurieren](xray-console-groups.md).
## Syntax für Filterausdrücke
Filterausdrücke können ein *Schlüsselwort*, einen unären oder binären *Operator* und einen *Wert* für den Vergleich enthalten.
```
keyword operator value
```
Für verschiedene Arten von Schlüsselwörtern sich unterschiedliche Operatoren erhältlich. Beispielsweise ist `responsetime` ein Zahlenschlüsselwort, das mit auf Zahlen bezüglichen Operatoren verglichen werden kann.
**Example — Anfragen, bei denen die Antwortzeit mehr als 5 Sekunden betrug**
```
responsetime > 5
```
Sie können mehrere Ausdrücke zu einem zusammengesetzten Ausdruck verbinden, indem Sie die Operatoren `AND` oder `OR` verwenden.
**Example — Anfragen mit einer Gesamtdauer von 5—8 Sekunden**
```
duration >= 5 AND duration <= 8
```
Einfache Schlüsselwörter und Operatoren finden Probleme nur auf der Ebene der Ablaufverfolgungen. Wenn ein Fehler dahinter auftritt, von Ihrer Anwendung jedoch berücksichtigt und nicht an den Benutzer zurückgegeben wird, findet eine Suche nach `error` diesen Fehler nicht.
Zum Finden von Ablaufverfolgungen mit nachgeordneten Fehlern können Sie [komplexe Schlüsselwörter](#console-filters-complex) `service()` und `edge()` verwenden. Diese Schlüsselwörter ermöglichen die Anwendung eines Filterausdrucks auf alle nachgeordneten Knoten, einen einzelnen nachgeordneten Knoten oder eine Edge zwischen zwei Knoten. Für mehr Granularität können Sie Services und Edges mit der [id()-Funktion](#console-filters-functions) nach Typ filtern.
## Boolesche Schlüsselwörter
Boolesche Schlüsselwortwerte sind entweder „true“ oder „false“. Verwenden Sie diese Schlüsselwörter, um Ablaufverfolgungen zu finden, die zu Fehlern geführt haben.
**Boolesche Schlüsselwörter**
+ `ok`— Der Statuscode der Antwort lautete 2XX Success.
+ `error`— Der Antwortstatuscode lautete 4XX Client Error.
+ `throttle`— Der Antwortstatuscode lautete 429 Too Many Requests.
+ `fault`— Der Antwortstatuscode lautete 5XX Server Error.
+ `partial`— Die Anfrage enthält unvollständige Segmente.
+ `inferred`— Die Anfrage hat abgeleitete Segmente.
+ `first`— Element ist das erste Element einer aufgezählten Liste.
+ `last`— Element ist das letzte Element einer Aufzählungsliste.
+ `remote`— Die Ursachenentität ist entfernt.
+ `root`— Service ist der Einstiegspunkt oder das Stammsegment einer Ablaufverfolgung.
Boolesche Operatoren finden Segmente, bei denen der angegebene Schlüssel `true` oder `false` ist.
**Boolesche Operatoren**
+ none — Der Ausdruck ist wahr, wenn das Schlüsselwort wahr ist.
+ `!`— Der Ausdruck ist wahr, wenn das Schlüsselwort falsch ist.
+ `=`, `!=` — Vergleicht den Wert des Schlüsselworts mit der Zeichenfolge `true` oder`false`. Diese Operatoren verhalten sich genauso wie die anderen Operatoren, sind jedoch expliziter.
**Example — Der Antwortstatus ist 2XX OK**
```
ok
```
**Example — der Antwortstatus ist nicht 2XX OK**
```
!ok
```
**Example — der Antwortstatus ist nicht 2XX OK**
```
ok = false
```
**Example — Der letzte aufgezählte Fehler-Trace hat den Fehlernamen „deserialize“**
```
rootcause.fault.entity { last and name = "deserialize" }
```
**Example — Anfragen mit entfernten Segmenten, bei denen die Abdeckung größer als 0,7 ist und der Dienstname „traces“ lautet**
```
rootcause.responsetime.entity { remote and coverage > 0.7 and name = "traces" }
```
**Example — Anfragen mit abgeleiteten Segmenten, bei denen der Diensttyp „aws:DynamoDB“ ist**
```
rootcause.fault.service { inferred and name = traces and type = "AWS::DynamoDB" }
```
**Example — Anfragen, die ein Segment mit dem Namen „Datenebene“ als Stamm haben**
```
service("data-plane") {root = true and fault = true}
```
## Zahlenschlüsselwörter
Verwenden Sie Zahlenschlüsselwörter, um nach Anforderungen mit einer bestimmten Reaktionszeit, Dauer oder einem bestimmten Reaktionsstatus zu suchen.
**Zahlenschlüsselwörter**
+ `responsetime`— Zeit, die der Server benötigt hat, um eine Antwort zu senden.
+ `duration`— Gesamtdauer der Anfrage, einschließlich aller Downstream-Aufrufe.
+ `http.status`— Statuscode der Antwort.
+ `index`— Position eines Elements in einer aufgezählten Liste.
+ `coverage`— Dezimaler Prozentsatz der Antwortzeit der Entität im Vergleich zur Antwortzeit des Stammsegments. Gilt nur für die Reaktionszeit der Ursachenentitäten.
**Zahlenoperatoren**
Zahlenschlüsselwörter verwenden Standard-Operatoren für Gleichheit und Vergleich.
+ `=`, `!=` — Das Schlüsselwort ist gleich oder ungleich einem Zahlenwert.
+ `<`,`<=`,`>`, `>=` — Das Schlüsselwort ist kleiner oder größer als ein Zahlenwert.
**Example — Der Antwortstatus ist nicht 200 OK**
```
http.status != 200
```
**Example — Anfrage, bei der die Gesamtdauer 5—8 Sekunden betrug**
```
duration >= 5 AND duration <= 8
```
**Example — Anfragen, die in weniger als 3 Sekunden erfolgreich abgeschlossen wurden, einschließlich aller Downstream-Aufrufe**
```
ok !partial duration <3
```
**Example — Entität mit einer aufgezählten Liste, deren Index größer als 5 ist**
```
rootcause.fault.service { index > 5 }
```
**Example — Anfragen, bei denen die letzte Entität, deren Abdeckung größer als 0,8 ist**
```
rootcause.responsetime.entity { last and coverage > 0.8 }
```
## Zeichenfolgen-Schlüsselwörter
Verwenden Sie String-Schlüsselwörter, um Traces mit einem bestimmten Text in den Headern der Anfrage oder nach einem bestimmten Benutzer IDs zu finden.
**Zeichenfolgen-Schlüsselwörter**
+ `http.url`— URL anfordern.
+ `http.method`— Methode anfordern.
+ `http.useragent`— User-Agent-Zeichenfolge anfordern.
+ `http.clientip`— Die IP-Adresse des Anforderers.
+ `user`— Wert des Benutzerfeldes in einem beliebigen Segment im Trace.
+ `name`— Der Name eines Dienstes oder einer Ausnahme.
+ `type`— Art der Dienstleistung.
+ `message`— Ausnahmemeldung.
+ `availabilityzone`— Wert des AvailabilityZone-Felds für ein beliebiges Segment im Trace.
+ `instance.id`— Wert des Instanz-ID-Felds in einem beliebigen Segment im Trace.
+ `resource.arn`— Wert des Ressourcen-ARN-Felds für ein beliebiges Segment im Trace.
Zeichenfolgenoperatoren finden Werte, die identisch mit bestimmtem Text sind oder diesen enthalten. Werte müssen stets in Anführungszeichen angegeben werden.
**Zeichenfolgenoperatoren**
+ `=`, `!=` — Das Schlüsselwort ist gleich oder ungleich einem Zahlenwert.
+ `CONTAINS`— Das Schlüsselwort enthält eine bestimmte Zeichenfolge.
+ `BEGINSWITH`, `ENDSWITH` — Das Schlüsselwort beginnt oder endet mit einer bestimmten Zeichenfolge.
**Example — http.url-Filter**
```
http.url CONTAINS "/api/game/"
```
Um zu testen, ob ein Feld in einer Ablaufverfolgung vorhanden ist (unabhängig von seinem Wert), prüfen Sie, ob es die leere Zeichenfolge enthält.
**Example — Benutzerfilter**
Finde alle Spuren mit dem Benutzer IDs.
```
user CONTAINS ""
```
**Example — Wählen Sie Traces mit einer Fehlerursache aus, zu der auch ein Dienst mit dem Namen „Auth“ gehört**
```
rootcause.fault.service { name = "Auth" }
```
**Example — wählt Traces mit einer Hauptursache für die Antwortzeit aus, deren letzter Service den Typ DynamoDB hat**
```
rootcause.responsetime.service { last and type = "AWS::DynamoDB" }
```
**Example — wählt Traces mit einer Fehlerursache aus, deren letzte Ausnahme die Meldung „Zugriff verweigert für account\$1id: 1234567890" enthält**
```
rootcause.fault.exception { last and message = "Access Denied for account_id: 1234567890"
```
## Komplexe Schlüsselwörter
Verwenden Sie komplexe Schlüsselwörter, um Anfragen anhand des Servicenamens, des Edge-Namens oder des Anmerkungswerts zu finden. Für Services und Edges können Sie einen zusätzlichen Filterausdruck angeben, der sich auf den Service oder die Edge bezieht. Für Anmerkungen können Sie nach dem Wert einer Anmerkung mit einem bestimmten Schlüssel filtern und dafür boolesche Werte, Zahlen oder Zeichenfolgenoperatoren verwenden.
**Komplexe Schlüsselwörter**
+ `annotation[key]`— Wert einer Anmerkung mit Feld. *key* Der Wert einer Anmerkung kann ein boolescher Wert, eine Zahl oder eine Zeichenfolge sein, sodass Sie jeden der Vergleichsoperatoren dieser Typen verwenden können. Sie können dieses Schlüsselwort in Kombination mit dem `edge` Schlüsselwort `service` or verwenden. Ein Kommentarschlüssel, der Punkte (Punkte) enthält, muss in eckige Klammern (**[]**) eingeschlossen werden.
+ `edge(source, destination) {filter}`— Verbindung zwischen Diensten *source* und*destination*. Optionale geschweifte Klammern können einen Filterausdruck enthalten, der für Segmente in dieser Verbindung gilt.
+ `group.name / group.arn`— Der Wert des Filterausdrucks einer Gruppe, auf den durch den Gruppennamen oder Gruppen-ARN verwiesen wird.
+ `json`— JSON-Ursachenobjekt. Schritte zum programmgesteuerten Erstellen [von JSON-Entitäten finden Sie unter Daten aus AWS X-Ray](xray-api-gettingdata.md) abrufen.
+ `service(name) {filter}`— Dienst mit Namen. *name* Optionale geschweifte Klammern können einen Filterausdruck enthalten, der für vom Service erstellte Segmente gilt.
Verwenden Sie das Schlüsselwort service, um Traces für Anfragen zu finden, die einen bestimmten Knoten auf Ihrer Trace-Map erreichen.
Komplexe Schlüsselwort-Operatoren finden Segmente, in denen der angegebene Schlüssel gesetzt wurde oder nicht.
**Komplexe Schlüsselwort-Operatoren**
+ none — Der Ausdruck ist wahr, wenn das Schlüsselwort gesetzt ist. Wenn das Schlüsselwort vom Typ Boolean ist, wird es als boolescher Wert ausgewertet.
+ `!`— Der Ausdruck ist wahr, wenn das Schlüsselwort nicht gesetzt ist. Wenn das Schlüsselwort vom Typ Boolean ist, wird es als boolescher Wert ausgewertet.
+ `=`, `!=` — Vergleicht den Wert des Schlüsselworts.
+ `edge(source, destination) {filter}`— Verbindung zwischen Diensten *source* und*destination*. Optionale geschweifte Klammern können einen Filterausdruck enthalten, der für Segmente in dieser Verbindung gilt.
+ `annotation[key]`— Wert einer Anmerkung mit Feld*key*. Der Wert einer Anmerkung kann ein boolescher Wert, eine Zahl oder eine Zeichenfolge sein, sodass Sie jeden der Vergleichsoperatoren dieser Typen verwenden können. Sie können dieses Schlüsselwort in Kombination mit dem `edge` Schlüsselwort `service` or verwenden.
+ `json`— JSON-Ursachenobjekt. Schritte zum programmgesteuerten Erstellen [von JSON-Entitäten finden Sie unter Daten aus AWS X-Ray](xray-api-gettingdata.md) abrufen.
Verwenden Sie das Schlüsselwort service, um Traces für Anfragen zu finden, die einen bestimmten Knoten auf Ihrer Trace-Map erreichen.
**Example — Servicefilter**
Anforderungen mit einem Aufruf an `api.example.com` mit einem Fehler (Fehler der Serie 500).
```
service("api.example.com") { fault }
```
Sie können den Servicenahmen ausschließen, um einen Filterausdruck auf alle Knoten in Ihrer Service-Übersicht anzuwenden.
**Example — Servicefilter**
Anfragen, die an einer beliebigen Stelle auf Ihrer Trace-Map einen Fehler verursacht haben.
```
service() { fault }
```
Das Edge-Schlüsselwort wendet einen Filterausdruck auf eine Verbindung zwischen zwei Knoten an.
**Example — Kantenfilter**
Anforderung, bei der der Service `api.example.com` einen Aufruf an `backend.example.com` vorgenommen hat, der mit einem Fehler fehlgeschlagen ist.
```
edge("api.example.com", "backend.example.com") { error }
```
Sie können auch den `!`-Operator mit Service- und Edge-Schlüsselwörtern verwenden, um einen Service oder eine Edge aus den Ergebnissen eines anderen Filterausdrucks auszuschließen.
**Example — Service- und Anfragefilter**
Anforderung, bei der die URL mit `http://api.example.com/` beginnt und `/v2/` enthält, aber kein Service mit dem Namen `api.example.com` erreicht wird.
```
http.url BEGINSWITH "http://api.example.com/" AND http.url CONTAINS "/v2/" AND !service("api.example.com")
```
**Example — Service- und Antwortzeitfilter**
Findet Spuren, bei denen der Wert eingestellt `http url` ist und die Reaktionszeit länger als 2 Sekunden ist.
```
http.url AND responseTime > 2
```
Für Anmerkungen können Sie alle Traces aufrufen, bei denen der Wert gesetzt `annotation[key]` ist, oder die Vergleichsoperatoren verwenden, die dem Wertetyp entsprechen.
**Example — Anmerkung mit Zeichenkettenwert**
Anforderungen mit einer Anmerkung mit dem Namen `gameid` und dem Zeichenfolgenwert `"817DL6VO"`.
```
annotation[gameid] = "817DL6VO"
```
**Example — Anmerkung ist gesetzt**
Anfragen mit einer Anmerkung namens `age` set.
```
annotation[age]
```
**Example — Anmerkung ist nicht gesetzt**
Anfragen ohne eine Anmerkung namens `age` set.
```
!annotation[age]
```
**Example — Anmerkung mit Zahlenwert**
Anforderungen mit einer Anmerkung mit einem numerischen Wert größer als 29.
```
annotation[age] > 29
```
**Example — Anmerkung in Kombination mit Service oder Edge**
```
service { annotation[request.id] = "917DL6VO" }
```
```
edge { source.annotation[request.id] = "916DL6VO" }
```
```
edge { destination.annotation[request.id] = "918DL6VO" }
```
**Example — Gruppe mit Benutzer**
Anfragen, bei denen Traces auf den `high_response_time` Gruppenfilter treffen (z. B.`responseTime > 3`) und der Benutzer den Namen Alice hat.
```
group.name = "high_response_time" AND user = "alice"
```
**Example — JSON mit der Ursachenentität**
Anforderungen mit übereinstimmenden Ursachenentitäten.
```
rootcause.json = #[{ "Services": [ { "Name": "GetWeatherData", "EntityPath": [{ "Name": "GetWeatherData" }, { "Name": "get_temperature" } ] }, { "Name": "GetTemperature", "EntityPath": [ { "Name": "GetTemperature" } ] } ] }]
```
## id-Funktion
Wenn Sie einen Service-Namen für die Schlüsselwörter `service` oder `edge` bereitstellen, erhalten Sie Ergebnisse für alle Knoten mit diesem Namen. Für eine präzisere Filterung können Sie mit der `id`-Funktion zusätzlich zu einem Namen einen Servicetyp angeben, um zwischen Knoten mit demselben Namen zu differenzieren.
Verwenden Sie die `account.id` Funktion, um ein bestimmtes Konto für den Dienst anzugeben, wenn Sie Traces von mehreren Konten in einem Monitoring-Konto anzeigen.
```
id(name: "service-name", type:"service::type", account.id:"account-ID")
```
Sie können die `id`-Funktion anstelle eines Service-Namens in Service- und Edge-Filtern verwenden.
```
service(id(name: "service-name", type:"service::type")) { filter }
```
```
edge(id(name: "service-one", type:"service::type"), id(name: "service-two", type:"service::type")) { filter }
```
AWS Lambda Funktionen führen beispielsweise zu zwei Knoten in der Trace-Map; einer für den Funktionsaufruf und einer für den Lambda-Service. Die zwei Knoten haben denselben Namen, aber unterschiedliche Arten. Ein Standard-Servicefilter findet Ablaufnachverfolgungen für beide.
**Example — Dienstfilter**
Anforderungen, die einen Fehler bei einem Service mit dem Namen `random-name` enthalten.
```
service("random-name") { error }
```
Verwenden Sie die `id`-Funktion zur Eingrenzung der Suche auf Fehler bei der Funktion selbst, unter Ausschluss von Fehlern vom Service.
**Example — Servicefilter mit ID-Funktion**
Anforderungen, die einen Fehler bei einem Service mit dem Namen `random-name` und dem Typ `AWS::Lambda::Function` enthalten.
```
service(id(name: "random-name", type: "AWS::Lambda::Function")) { error }
```
Um Knoten nach Typ zu suchen, können Sie den Namen auch vollständig ausschließen.
**Example — Servicefilter mit ID-Funktion und Servicetyp**
Anforderungen, die einen Fehler bei einem Service des Typs `AWS::Lambda::Function` enthalten.
```
service(id(type: "AWS::Lambda::Function")) { error }
```
Um nach Knoten für einen bestimmten Knoten zu suchen AWS-Konto, geben Sie eine Konto-ID an.
**Example — Servicefilter mit ID-Funktion und Konto-ID**
Anfragen, die einen Dienst innerhalb einer bestimmten Konto-ID beinhalten`AWS::Lambda::Function`.
```
service(id(account.id: "account-id"))
```
# Kontenübergreifende Rückverfolgung
AWS X-Ray unterstützt *kontenübergreifende Beobachtbarkeit*, sodass Sie Anwendungen überwachen und Fehler beheben können, die sich über mehrere Konten innerhalb eines. AWS-Region Sie können Ihre Metriken, Protokolle und Traces in allen verknüpften Konten nahtlos suchen, visualisieren und analysieren, als ob Sie mit einem einzigen Konto arbeiten würden. Auf diese Weise erhalten Sie einen vollständigen Überblick über Anfragen, die über mehrere Konten hinweg eingehen. Sie können kontenübergreifende Traces in der X-Ray-Trace-Map und auf den Traces-Seiten in der [CloudWatchKonsole](https://console.aws.amazon.com/cloudwatch/) anzeigen.
Die gemeinsam genutzten Observability-Daten können jede der folgenden Telemetriearten beinhalten:
+ Metriken bei Amazon CloudWatch
+ Gruppen in Amazon CloudWatch Logs protokollieren
+ Spuren in AWS X-Ray
+ Anwendungen in Amazon CloudWatch Application Insights
## Konfigurieren Sie die kontoübergreifende Beobachtbarkeit
*Um die kontenübergreifende Beobachtbarkeit zu aktivieren, richten Sie ein oder mehrere AWS *Überwachungskonten* ein und verknüpfen Sie sie mit mehreren Quellkonten.* Ein Monitoring-Konto ist ein zentrales System AWS-Konto , das Beobachtungsdaten, die aus Quellkonten generiert wurden, einsehen und mit ihnen interagieren kann. Ein Quellkonto ist eine Person AWS-Konto , die Beobachtbarkeitsdaten für die darin enthaltenen Ressourcen generiert.
Quellkonten teilen ihre Beobachtbarkeitsdaten mit Monitoringkonten. Traces werden von jedem Quellkonto auf bis zu fünf Überwachungskonten kopiert. Kopien der Traces von den Quellkonten auf das erste Überwachungskonto sind kostenlos. Kopien von Traces, die an zusätzliche Überwachungskonten gesendet werden, werden jedem Quellkonto auf der Grundlage der Standardpreise in Rechnung gestellt. Weitere Informationen finden Sie unter [AWS X-Ray Preise](https://aws.amazon.com/xray/pricing/) und [ CloudWatch Amazon-Preise](https://aws.amazon.com/cloudwatch/pricing/).
Verwenden Sie die CloudWatch Konsole oder die neuen Observability Access Manager-Befehle in der AND-API, um Verknüpfungen zwischen Monitoring-Konten AWS CLI und Quellkonten zu erstellen. Weitere Informationen finden Sie unter [Kontoübergreifende Beobachtbarkeit von CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html).
**Anmerkung**
Röntgenspuren werden dort abgerechnet, AWS-Konto wo sie empfangen wurden. Wenn sich eine [Stichprobenanfrage](xray-concepts.md#xray-concepts-sampling) über mehrere Dienste erstreckt AWS-Konto, zeichnet jedes Konto eine separate Ablaufverfolgung auf, und alle Traces verwenden dieselbe Trace-ID. Weitere Informationen zu kontenübergreifenden Observability-Preisen finden Sie unter Preise und [AWS X-Ray[ CloudWatch Amazon-Preise](https://aws.amazon.com/cloudwatch/pricing/)](https://aws.amazon.com/xray/pricing/).
## Kontoübergreifende Traces anzeigen
Kontoübergreifende Ablaufverfolgungen werden im Überwachungskonto angezeigt. Für jedes Quellkonto werden nur lokale Ablaufverfolgungen für dieses spezifische Konto angezeigt. In den folgenden Abschnitten wird davon ausgegangen, dass Sie beim Monitoring-Konto angemeldet sind und die CloudWatch Amazon-Konsole geöffnet haben. Sowohl auf der Trace-Map- als auch auf der Traces-Seite wird in der oberen rechten Ecke ein Abzeichen für das Überwachungskonto angezeigt.
![\[Badge für das Überwachungskonto\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/crossaccount-monitoring-account.png)
### Karte verfolgen
Wählen Sie in der CloudWatch Konsole im linken Navigationsbereich unter **X-Ray-Traces** die Option **Trace Map** aus. In der Trace-Map werden standardmäßig Knoten für alle Quellkonten angezeigt, die Traces an das Überwachungskonto senden, sowie Knoten für das Überwachungskonto selbst. Wählen Sie auf der Trace-Map oben links **Filter** aus, um die Trace-Map mithilfe der Drop-down-Liste **Konten** zu filtern. Nachdem ein Kontofilter angewendet wurde, sind Dienstknoten von Konten, die nicht dem aktuellen Filter entsprechen, ausgegraut.
![\[Gefilterte Trace-Map\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/crossaccount-servicemap-account-filter.png)
Wenn Sie einen Dienstknoten auswählen, enthält der Bereich mit den Knotendetails die Konto-ID und das Label des Dienstes.
![\[Bereich mit Knotendetails\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/crossaccount-servicemap-node-detail.png)
Wählen Sie in der oberen rechten Ecke der Trace-Map die Option **Listenansicht** aus, um eine Liste der Dienstknoten anzuzeigen. Die Liste der Dienstknoten umfasst Dienste aus dem Überwachungskonto und allen konfigurierten Quellkonten. Filtern Sie die Liste der Knoten nach **Kontoname** oder **Konto-ID**, indem Sie sie aus dem **Knotenfilter** auswählen.
![\[Gefilterte Serviceliste\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/crossaccount-servicelist-account-filter.png)
### Ablaufverfolgungen
**Rufen Sie die Trace-Details für Traces auf, die sich über mehrere Konten erstrecken, indem Sie die CloudWatch Konsole vom Monitoring-Konto aus öffnen und im linken Navigationsbereich unter **X-Ray-Traces** die Option Traces auswählen.** Sie können diese Seite auch öffnen, indem Sie einen Knoten in der **X-Ray-Trace-Map** auswählen und dann im Bereich mit den Knotendetails die Option **Traces anzeigen** wählen.
Die Seite „**Traces**“ unterstützt Abfragen nach Konto-ID. [Geben Sie zunächst eine Abfrage ein](xray-console-filters.md), die ein oder mehrere Konten IDs umfasst. Im folgenden Beispiel werden Traces abgefragt, die die Konto-ID X** oder *Y* durchlaufen haben:
```
service(id(account.id:"X")) OR service(id(account.id:"Y"))
```
![\[Traces nach Konto abfragen\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/crossaccount-traces-query-by-account.png)
Verfeinern Sie Ihre Anfrage nach **Konto**. Wählen Sie ein oder mehrere Konten aus der Liste aus und klicken Sie dann **auf Zur Abfrage hinzufügen**.
![\[Verfeinern Sie die Trace-Abfrage nach Konto\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/crossaccount-traces-refine-by-account.png)
### Einzelheiten verfolgen
Sehen Sie sich die Details einer Ablaufverfolgung an, indem Sie sie aus der **Traces-Liste** unten auf der **Traces-Seite** auswählen. Die **Trace-Details** werden angezeigt, einschließlich einer Übersicht mit Ablaufverfolgungsdetails mit Dienstknoten aus allen Konten, die der Trace durchlaufen hat. Wählen Sie einen bestimmten Dienstknoten aus, um das entsprechende Konto anzuzeigen.
Im Abschnitt **Segment-Timeline** werden die Kontodetails für jedes Segment in der Timeline angezeigt.
![\[Zeitleiste der Segmente\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/crossaccount-traces-segment-timeline.png)
# Nachverfolgung ereignisgesteuerter Anwendungen
AWS X-Ray unterstützt die Ablaufverfolgung ereignisgesteuerter Anwendungen mithilfe von Amazon SQS und. AWS Lambda Verwenden Sie die CloudWatch Konsole, um eine verbundene Ansicht jeder Anfrage zu sehen, während sie bei Amazon SQS in die Warteschlange gestellt und von einer oder mehreren Lambda-Funktionen verarbeitet wird. Traces von Upstream-Nachrichtenproduzenten werden automatisch mit Traces von nachgeschalteten Lambda-Consumer-Knoten verknüpft, wodurch eine end-to-end Ansicht der Anwendung erstellt wird.
**Anmerkung**
Jedes Trace-Segment kann mit bis zu 20 Traces verknüpft werden, wobei ein Trace maximal 100 Links enthalten kann. In bestimmten Szenarien kann das Verknüpfen zusätzlicher Spuren dazu führen, dass die [maximale Größe des Trace-Dokuments](https://docs.aws.amazon.com/general/latest/gr/xray.html#limits_xray) überschritten wird, was zu einer möglicherweise unvollständigen Ablaufverfolgung führen kann. Dies kann beispielsweise passieren, wenn eine Lambda-Funktion mit aktivierter Ablaufverfolgung viele SQS-Nachrichten in einem einzigen Aufruf an eine Warteschlange sendet. Wenn Sie auf dieses Problem stoßen, ist eine Abhilfemaßnahme verfügbar, die X-Ray SDKs verwendet. Weitere Informationen finden Sie im X-Ray-SDK für [Java](https://github.com/aws/aws-xray-sdk-java#oversampling-mitigation), [Node.js](https://github.com/aws/aws-xray-sdk-node/tree/master/packages/core#oversampling-mitigation), [Python](https://github.com/aws/aws-xray-sdk-python#oversampling-mitigation), [Go](https://github.com/aws/aws-xray-sdk-go#oversampling-mitigation) oder [.NET](https://github.com/aws/aws-xray-sdk-dotnet#oversampling-mitigation).
## Verknüpfte Traces in der Trace-Map anzeigen
Verwenden Sie die **Trace-Map-Seite** in der [CloudWatchKonsole](https://console.aws.amazon.com/cloudwatch/), um eine Trace-Map mit Traces von Nachrichtenproduzenten anzuzeigen, die mit Traces von Lambda-Verbrauchern verknüpft sind. Diese Links werden mit einer gestrichelten Linie angezeigt, die den Amazon SQS-Knoten mit den nachgeschalteten Lambda-Consumer-Knoten verbindet.
![\[Grenze zwischen Amazon SQS- und Lambda-Knoten.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-batch-servicemap-linkededge.png)
Wählen Sie eine gestrichelte Linie aus, um ein Histogramm mit dem *Alter eines empfangenen Ereignisses* anzuzeigen, das die Verteilung des Ereignisalters bei Empfang durch Verbraucher darstellt. Das Alter wird jedes Mal berechnet, wenn ein Ereignis empfangen wird.
![\[Kante mit Altershistogramm des empfangenen Ereignisses.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-servicemap-linkededgedetails-cw.png)
## Details der verknüpften Ablaufverfolgung anzeigen
**Trace-Details anzeigen, die von einem Nachrichtenproduzenten, einer Amazon SQS SQS-Warteschlange oder einem Lambda-Consumer gesendet wurden:**
1. Verwenden Sie die **Trace-Map**, um einen Message Producer, Amazon SQS oder Lambda Consumer Node auszuwählen.
1. Wählen Sie im Bereich mit den Knotendetails die Option **Traces anzeigen**, um eine Liste von Traces anzuzeigen. Sie können in der CloudWatch Konsole auch direkt zur Seite „**Traces**“ navigieren.
1. Wählen Sie einen bestimmten Trace aus der Liste aus, um die Seite mit den Trace-Details zu öffnen. Auf der Seite mit den Ablaufverfolgungsdetails wird eine Meldung angezeigt, wenn der ausgewählte Trace Teil eines verknüpften Trace-Satzes ist.
![\[Details zur verknüpften Ablaufverfolgung\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-batch-tracedetails-header.png)
In der Karte mit den Verfolgungsdetails werden die aktuelle Spur zusammen mit den verknüpften Spuren flussaufwärts und flussabwärts angezeigt, die jeweils in einem Feld enthalten sind, das die Grenzen der einzelnen Spuren angibt. Wenn die aktuell ausgewählte Spur mit mehreren Upstream- oder Downstream-Leiterbahnen verknüpft ist, werden die Knoten innerhalb der Upstream- oder Downstream-verknüpften Spuren gestapelt, und die Schaltfläche „**Spur auswählen**“ wird angezeigt.
![\[Mehrere verknüpfte Upstream-Spuren\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-batch-tracedetails-tracemap.png)
Unter der Karte mit den Spurdetails wird eine Zeitleiste mit Spurensegmenten angezeigt, einschließlich verknüpfter Spuren flussaufwärts und flussabwärts. Wenn mehrere stromaufwärts oder flussabwärts verknüpfte Spuren vorhanden sind, können deren Segmentdetails nicht angezeigt werden. Um Segmentdetails für eine einzelne Spur innerhalb einer Reihe verknüpfter Spuren anzuzeigen, [wählen Sie eine einzelne Spur](#xray-tracelinking-filterbatch) aus, wie unten beschrieben.
![\[Die Zeitleiste der Segmente zeigt verknüpfte Spuren\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-batch-tracedetails-timeline.png)
## Wählen Sie eine einzelne Spur innerhalb einer Reihe verknüpfter Spuren aus
**Filtert einen verknüpften Satz von Spuren zu einer einzelnen Spur, um Segmentdetails in der Timeline zu sehen.**
1. **Wählen Sie auf der Karte mit den Trace-Details** unter den verknüpften Spuren die Option Spur auswählen aus. Eine Liste von Spuren wird angezeigt.
![\[Verknüpfte Trace-Liste\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-batch-tracedetails-tracelist.png)
1. Wählen Sie das Optionsfeld neben einer Spur aus, um sie in der Karte mit den Ablaufverfolgungsdetails anzuzeigen.
1. Wählen Sie „**Spurauswahl abbrechen“**, um den gesamten Satz verknüpfter Spuren anzuzeigen.
![\[Einzelne verknüpfte Spur\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-batch-tracedetails-filteredbatch.png)
# Verwendung von Latenzhistogrammen
Wenn Sie einen Knoten oder eine Kante auf einer AWS X-Ray [Trace-Map](xray-console-servicemap.md) auswählen, zeigt die X-Ray-Konsole ein Latenzverteilungshistogramm an.
## Latency
Als Latenz wird die Zeit zwischen dem Start und dem Abschluss einer Anforderung bezeichnet. Ein Histogramm zeigt eine Verteilung von Latenzen. Er zeigt Dauer auf der x-Achse und den Prozentsatz der Anforderungen, die jeder Dauer entsprechen, auf der y-Achse.
Dieses Histogramm zeigt einen Service, der die meisten Anfragen in weniger als 300 ms abschließt. Ein kleiner Prozentsatz von Anfragen dauert 2 Sekunden, und einige Ausreißer nehmen noch mehr Zeit in Anspruch.
![\[Latenz-Histogramme mit der Dauer auf der x-Achse und dem Prozentsatz der Anfragen für jede Dauer auf der y-Achse\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/scorekeep-servicemap-histogram.png)
## Interpretieren von Service-Details
Service-Histogramme und Edge-Histogramme bieten eine visuelle Darstellung der Latenz aus der Sicht eines Services oder eines Anforderers.
+ Wählen Sie einen *Dienstknoten* aus, indem Sie auf den Kreis klicken. X-Ray zeigt ein Histogramm für Anfragen, die vom Dienst bedient werden. Die Latenzen sind die, die der Service aufgezeichnet hat; dazu gehört nicht die Netzwerklatenz zwischen dem Service und dem Auftraggeber.
+ Wählen Sie eine *Kante* aus, indem Sie auf die Linie oder die Pfeilspitze der Kante zwischen zwei Diensten klicken. X-Ray zeigt ein Histogramm für Anfragen des Anforderers, die vom Downstream-Dienst bearbeitet wurden. Die Latenzen sind die vom Auftraggeber aufgezeichneten; dazu gehört die Latenz in der Netzwerkverbindung zwischen den beiden Services.
Zur Interpretation des Panel-Histogramms mit den **Servicedetails** können Sie die Werte betrachten, die am stärksten von den meisten Werten im Histogramm abweichen. Diese *Ausreißer* sind als Spitzen im Histogramm zu sehen und Sie können die Ablaufverfolgungen für einen bestimmten Bereich untersuchen, um zu sehen, was vor sich geht.
Wählen Sie zur Anzeige nach Latenz gefilterter Ablaufverfolgungen einen Bereich im Histogramm aus. Klicken Sie an die Stelle, an der die Auswahl beginnen soll, und ziehen Sie von links nach rechts, um einen Bereich von Latenzen hervorzuheben, der in den Ablaufverfolgungsfilter eingeschlossen werden soll.
![\[Wählen Sie einen Bereich für die Anzeige von Ablaufverfolgungen aus, indem Sie auf den Startpunkt klicken und von links nach rechts ziehen, um den Bereich für den Ablaufverfolgungsfilter auszuwählen.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/scorekeep-servicemap-servicedetails-selection.png)
Nach Auswahl eines Bereichs können Sie den **Zoom** wählen, um nur diesen Teil des Histogramms anzuzeigen, und Ihre Auswahl verfeinern.
![\[Auswahl des Zooms zur Anzeige des ausgewählten Bereichs im Histogramm\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/scorekeep-servicemap-servicedetails-zoom.png)
Sobald Sie den Fokus auf den interessierenden Bereich gesetzt haben, wählen Sie **Ablaufverfolgungen anzeigen**.
# Nutzung von X-Ray Insights
AWS X-Ray analysiert kontinuierlich die Trace-Daten in Ihrem Konto, um neu auftretende Probleme in Ihren Anwendungen zu identifizieren. Wenn die Fehlerraten den erwarteten Bereich überschreiten, werden *Erkenntnisse* gewonnen, die das Problem aufzeichnen und seine Auswirkungen verfolgen, bis es behoben ist. Mithilfe von Erkenntnissen können Sie:
+ Identifizieren Sie, wo in Ihrer Anwendung Probleme auftreten, die Hauptursache des Problems und die damit verbundenen Auswirkungen. Anhand der von Insights bereitgestellten Auswirkungsanalyse können Sie den Schweregrad und die Priorität eines Problems ableiten.
+ Erhalten Sie Benachrichtigungen, wenn sich das Problem im Laufe der Zeit ändert. Insights-Benachrichtigungen können mithilfe von Amazon EventBridge in Ihre Überwachungs- und Warnlösung integriert werden. Diese Integration ermöglicht es Ihnen, je nach Schweregrad des Problems automatisierte E-Mails oder Benachrichtigungen zu versenden.
Die X-Ray-Konsole identifiziert Knoten mit laufenden Vorfällen in der Trace-Map. Um eine Zusammenfassung der Erkenntnisse zu erhalten, wählen Sie den betroffenen Knoten aus. Sie können Einblicke auch anzeigen und filtern, indem Sie im Navigationsbereich auf der linken Seite **Insights** auswählen.
![\[Verfolgen Sie den Kartenknoten mit einer Zusammenfassung der Erkenntnisse.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-insights-servicemap.png)
X-Ray generiert einen Einblick, wenn es eine *Anomalie* in einem oder mehreren Knoten der Service-Map erkennt. Der Service verwendet statistische Modelle, um die erwarteten Fehlerraten der Dienste in Ihrer Anwendung vorherzusagen. Im vorherigen Beispiel handelt es sich bei der Anomalie um eine Zunahme von Fehlern von AWS Elastic Beanstalk. Auf dem Elastic Beanstalk-Server kam es zu mehreren Timeouts bei API-Aufrufen, was zu einer Anomalie in den Downstream-Knoten führte.
## Einblicke in der X-Ray-Konsole aktivieren
Insights muss für jede Gruppe aktiviert sein, mit der Sie Insights-Funktionen verwenden möchten. Sie können Insights auf der **Gruppenseite** aktivieren.
1. Öffnen Sie die [X-Ray-Konsole](https://console.aws.amazon.com/xray/home#).
1. Wählen Sie eine bestehende Gruppe aus oder erstellen Sie eine neue, indem **Sie Gruppe erstellen** und dann **Insights aktivieren** auswählen. Weitere Informationen zur Konfiguration von Gruppen in der X-Ray-Konsole finden Sie unter[Gruppen konfigurieren](xray-console-groups.md).
1. Wählen Sie im Navigationsbereich auf der linken Seite **Insights** und dann einen Insight aus, den Sie sich ansehen möchten.
![\[Liste der Erkenntnisse in der X-Ray-Konsole.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-insights.png)
**Anmerkung**
X-Ray verwendet GetInsightSummaries GetInsight, GetInsightEvents, und GetInsightImpactGraph API-Operationen, um Daten aus Insights abzurufen.
Weitere Informationen finden Sie unter [Wie AWS X-Ray funktioniert mit IAM](security_iam_service-with-iam.md).
## Aktivieren Sie Insights-Benachrichtigungen
Bei Insights-Benachrichtigungen wird für jedes Insight-Ereignis eine Benachrichtigung erstellt, z. B. wenn ein Insight erstellt wird, sich erheblich ändert oder geschlossen wird. Kunden können diese Benachrichtigungen über EventBridge Amazon-Ereignisse erhalten und bedingte Regeln verwenden, um Aktionen wie SNS-Benachrichtigungen, Lambda-Aufrufe, das Posten von Nachrichten in eine SQS-Warteschlange oder eines der unterstützten Ziele zu ergreifen. EventBridge Insights-Benachrichtigungen werden nach bestem Wissen versendet, können aber nicht garantiert werden. Weitere Informationen zu Zielen finden Sie unter [Amazon EventBridge Targets](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-targets.html).
**Auf der Gruppenseite können Sie Insights-Benachrichtigungen für jede Gruppe aktivieren, für die Insights aktiviert sind.**
**Um Benachrichtigungen für eine X-Ray-Gruppe zu aktivieren**
1. Öffnen Sie die [X-Ray-Konsole](https://console.aws.amazon.com/xray/home#).
1. Wählen Sie eine bestehende Gruppe aus oder erstellen Sie eine neue, indem **Sie Gruppe erstellen** wählen. Vergewissern Sie sich, dass **Insights aktivieren** ausgewählt ist, und wählen Sie dann **Benachrichtigungen aktivieren** aus. Weitere Informationen zur Konfiguration von Gruppen in der X-Ray-Konsole finden Sie unter[Gruppen konfigurieren](xray-console-groups.md).
**So konfigurieren Sie EventBridge bedingte Amazon-Regeln**
1. Öffnen Sie die [ EventBridge Amazon-Konsole](https://console.aws.amazon.com/events/home).
1. Navigieren Sie in der linken Navigationsleiste zu **Regeln** und wählen Sie **Regel erstellen** aus.
1. Geben Sie einen Namen und eine Beschreibung für die Regel ein.
1. Wählen Sie **Ereignismuster** und anschließend **Benutzerdefiniertes Muster** aus. Geben Sie ein Muster an, das `"source": [ "aws.xray" ]` und enthält`"detail-type": [ "AWS X-Ray Insight Update" ]`. Im Folgenden finden Sie einige Beispiele für mögliche Muster.
+ Ereignismuster, das allen eingehenden Ereignissen aus X-Ray Insights entspricht:
```
{
"source": [ "aws.xray" ],
"detail-type": [ "AWS X-Ray Insight Update" ]
}
```
+ Ereignismuster, das einem bestimmten Wert entspricht **state** und**category**:
```
{
"source": [ "aws.xray" ],
"detail-type": [ "AWS X-Ray Insight Update" ],
"detail": {
"State": [ "ACTIVE" ],
"Category": [ "FAULT" ]
}
}
```
1. Wählen und konfigurieren Sie die Ziele, die Sie aufrufen möchten, wenn ein Ereignis dieser Regel entspricht.
1. (Optional) Geben Sie Tags an, um diese Regel leichter identifizieren und auswählen zu können.
1. Wählen Sie **Erstellen** aus.
**Anmerkung**
X-Ray Insights-Benachrichtigungen senden Ereignisse an Amazon EventBridge, das derzeit keine vom Kunden verwalteten Schlüssel unterstützt. Weitere Informationen finden Sie unter [Datenschutz in AWS X-Ray](xray-console-encryption.md).
## Überblick über Insight
Die Übersichtsseite für einen Einblick versucht, drei wichtige Fragen zu beantworten:
+ Was ist das zugrundeliegende Problem?
+ Was ist die Hauptursache?
+ Was ist die Auswirkung?
Der Abschnitt **Anomale Dienste** zeigt für jeden Service einen Zeitplan, der die Veränderung der Fehlerraten während des Vorfalls veranschaulicht. Die Zeitleiste zeigt die Anzahl der Traces mit Fehlern auf einem durchgehenden Band, das die erwartete Anzahl von Fehlern auf der Grundlage des aufgezeichneten Datenverkehrs angibt. Die Dauer der Erkenntnisse wird im *Incident-Fenster* visualisiert. Das Incident-Fenster beginnt, wenn X-Ray beobachtet, dass die Metrik anomal wird, und bleibt bestehen, solange der Insight aktiv ist.
Das folgende Beispiel zeigt eine Zunahme von Fehlern, die zu einem Vorfall geführt haben:
![\[Übersichtsseite eines X-Ray-Einblicks.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-insights-overview.png)
Im Abschnitt „**Ursache**“ wird eine Ablaufverfolgungsübersicht angezeigt, die sich auf den Ursachendienst und den betroffenen Pfad konzentriert. Sie können die nicht betroffenen Knoten ausblenden, indem Sie auf das Augensymbol oben rechts in der Ursachenkarte klicken. Der Root Cause Service ist der am weitesten flussabwärts gelegene Knoten, an dem X-Ray eine Anomalie identifiziert hat. Dabei kann es sich um einen Service handeln, den Sie instrumentiert haben, oder um einen externen Service, den Ihr Service mit einem instrumentierten Client aufgerufen hat. Wenn Sie beispielsweise Amazon DynamoDB mit einem instrumentierten AWS SDK-Client aufrufen, führt eine Zunahme von Fehlern durch DynamoDB zu Erkenntnissen mit DynamoDB als Hauptursache.
Um die Ursache weiter zu untersuchen, wählen Sie im Ursachendiagramm die Option **Ursachendetails anzeigen** aus. Sie können die **Analytics-Seite** verwenden, um die Grundursache und zugehörige Meldungen zu untersuchen. Weitere Informationen finden Sie unter [Interaktion mit der -Analysekonsole](xray-console-analytics.md).
![\[Übersichtsseite eines X-Ray-Einblicks.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-insights-root-cause.png)
Fehler, die sich in der Map weiter flussaufwärts fortsetzen, können sich auf mehrere Knoten auswirken und mehrere Anomalien verursachen. Wenn ein Fehler vollständig an den Benutzer weitergegeben wird, der die Anfrage gestellt hat, ist das Ergebnis ein *Client-Fehler*. Dies ist ein Fehler im Stammknoten der Trace-Map. Das **Impact-Diagramm** bietet einen Überblick über das Kundenerlebnis für die gesamte Gruppe. Dieses Kundenerlebnis wird anhand der Prozentsätze der folgenden Zustände berechnet: **Fehler, **Fehler****, **Drosselung** und **Okay**.
![\[Wirkungsdiagramm für einen Röntgenvorfall.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-insights-impact.png)
Dieses Beispiel zeigt eine Zunahme von Traces mit einem Fehler am Stammknoten während eines Vorfalls. Vorfälle in nachgelagerten Diensten entsprechen nicht immer einer Zunahme von Client-Fehlern.
Wenn Sie **Analyze Insight** wählen, wird die X-Ray Analytics-Konsole in einem Fenster geöffnet, in dem Sie tief in die Spuren eintauchen können, die den Einblick verursacht haben. Weitere Informationen finden Sie unter [Interaktion mit der -Analysekonsole](xray-console-analytics.md).
**Auswirkungen verstehen**
AWS X-Ray misst im Rahmen der Generierung von Erkenntnissen und Benachrichtigungen die Auswirkungen, die durch ein laufendes Problem verursacht werden. Die Auswirkungen werden auf zwei Arten gemessen:
+ Auswirkungen auf die [X-Ray-Gruppe](xray-console-groups.md)
+ Auswirkungen auf den Ursachendienst
Diese Auswirkung wird durch den Prozentsatz der Anfragen bestimmt, die innerhalb eines bestimmten Zeitraums fehlschlagen oder einen Fehler verursachen. Diese Auswirkungsanalyse ermöglicht es Ihnen, den Schweregrad und die Priorität des Problems anhand Ihres speziellen Szenarios abzuleiten. Diese Auswirkung ist zusätzlich zu den Insights-Benachrichtigungen als Teil des Konsolen-Erlebnisses verfügbar.
**Deduplizierung**
AWS X-Ray Insights dedupliziert Probleme bei mehreren Microservices. Es verwendet die Anomalieerkennung, um den Service zu ermitteln, der die Hauptursache eines Problems ist, ermittelt, ob andere verwandte Dienste aufgrund derselben Grundursache ein anomales Verhalten zeigen, und zeichnet das Ergebnis in Form eines einzigen Einblicks auf.
## Überprüfen Sie den Fortschritt eines Insights
X-Ray bewertet die Erkenntnisse in regelmäßigen Abständen neu, bis sie behoben sind, und zeichnet jede wichtige zwischenzeitliche Änderung als [Benachrichtigung](#xray-console-insight-notifications) auf, die als EventBridge Amazon-Ereignis gesendet werden kann. Auf diese Weise können Sie Prozesse und Workflows erstellen, um festzustellen, wie sich das Problem im Laufe der Zeit verändert hat, und geeignete Maßnahmen ergreifen, z. B. das Senden einer E-Mail oder die Integration in ein Warnsystem mithilfe von. EventBridge
Sie können Vorfallereignisse in der **Impact-Timeline** auf der Seite **Inspect überprüfen**. Standardmäßig zeigt die Zeitleiste den Service an, der am stärksten betroffen ist, bis Sie einen anderen Service auswählen.
![\[Untersuchen Sie die Seite mit der Zeitleiste der Auswirkungen.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-insights-inspect.png)
Um eine Ablaufkarte und Grafiken für ein Ereignis zu sehen, wählen Sie es aus der Wirkungszeitleiste aus. Die Trace-Map zeigt die Dienste in Ihrer Anwendung, die von dem Vorfall betroffen sind. Unter **Auswirkungsanalyse** zeigen Diagramme die Fehlerzeitpläne für den ausgewählten Knoten und für die Clients in der Gruppe.
![\[Wirkungsanalysediagramm für einen Einblick in X-Ray.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/console-insights-inspect-analysis.png)
Wenn Sie sich die Spuren eines Vorfalls genauer ansehen möchten, wählen Sie auf der Seite **Inspizieren** die Option **Ereignis analysieren** aus. Sie können die **Analytics-Seite** verwenden, um die Liste der Traces zu verfeinern und die betroffenen Benutzer zu identifizieren. Weitere Informationen finden Sie unter [Interaktion mit der -Analysekonsole](xray-console-analytics.md).
# Interaktion mit der -Analysekonsole
Die AWS X-Ray Analytics-Konsole ist ein interaktives Tool zur Interpretation von Trace-Daten, mit dem Sie schnell nachvollziehen können, wie Ihre Anwendung und die zugrunde liegenden Dienste funktionieren. Die Konsole ermöglicht Ihnen das Erkunden, Analysieren und Visualisieren von Ablaufverfolgungen durch interaktive Reaktionszeit und Zeitreihen-Diagramme.
Bei der Auswahl in der Analysekonsole erstellt die Konsole Filter für die ausgewählte Teilmenge aller Ablaufverfolgungen. Sie können die aktiven Datasets mit zunehmend granularen Filtern anpassen, indem Sie auf die Diagramme und die Bereiche der Metriken und Felder klicken, die der aktuellen Ablaufverfolgungsreihe zugeordnet sind.
**Topics**
+ [Konsolenfunktionen](#xray-console-analytics-features)
+ [Reaktionszeitverteilung](#xray-console-analytics-response)
+ [Zeitreihenaktivität](#xray-console-analytics-time)
+ [Workflow-Beispiele](#xray-console-analytics-workflows)
+ [Achten Sie auf Fehler auf im Servicediagramm.](#xray-console-analytics-observe-faults)
+ [Spitzen der Reaktionszeit erkennen](#xray-console-analytics-response-peaks)
+ [Alle Ablaufverfolgungen mit einem Statuscode anzeigen](#xray-console-analytics-response-peaks)
+ [Alle Elemente in einer Untergruppe und einem Benutzer zugeordnete Elemente anzeigen](#xray-console-analytics-subgroups)
+ [Vergleichen Sie zwei Ablaufverfolgungssätze mit unterschiedlichen Kriterien](#xray-console-analytics-compare)
+ [Zeigen Sie Details einer interessanten Ablaufverfolgung an](#xray-console-analytics-identify)
## Konsolenfunktionen
Die X-Ray Analytics-Konsole verwendet die folgenden Hauptfunktionen zum Gruppieren, Filtern, Vergleichen und Quantifizieren von Trace-Daten.
### Features
| Funktion | Beschreibung |
| --- | --- |
| **Gruppen** | Die anfangs ausgewählte Gruppe ist `Default`. Zum Ändern der abgerufenen Gruppe wählen Sie eine andere Gruppe aus dem Menü rechts neben der Filterausdruck-Suchleiste aus. Weitere Informationen zu Gruppen finden Sie unter [Verwenden von Filterausdrücken mit Gruppen](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-filters.html#groups). |
| **Abgerufene Ablaufverfolgungen** | Standardmäßig generiert die Analysekonsole Diagramme auf Grundlage aller Ablaufverfolgungen in der ausgewählten Gruppe. Abgerufene Ablaufverfolgungen stehen für alle Ablaufverfolgungen in Ihrem Arbeitssatz. Auf dieser Kachel finden Sie die Anzahl der Ablaufverfolgungen. Mit Filterausdrücken an der Hauptsuchleiste optimieren und aktualisieren Sie die abgerufenen Ablaufverfolgungen. |
| **In Diagrammen anzeigen/In Diagrammen ausblenden** | Ein Schalter zum Vergleichen der aktiven Gruppe mit den abgerufenen Ablaufverfolgungen. Zum Vergleichen der Daten im Zusammenhang mit der Gruppe mit sämtlichen aktiven Filtern klicken Sie auf **In Diagrammen anzeigen**. Zum Entfernen dieser Ansicht aus den Diagrammen wählen Sie **In Diagrammen ausblenden**. |
| **Gefilterter Ablaufverfolgungssatz A** | Wenden Sie durch Interaktionen mit den Grafiken und Tabellen Filter an, um die Kriterien für den **gefilterten Trace-Satz** A zu erstellen. Wenn die Filter angewendet werden, werden die Anzahl der zutreffenden Spuren und der Prozentsatz der abgerufenen Spuren an der Gesamtzahl der abgerufenen Spuren innerhalb dieser Kachel berechnet. Filter werden auf der Kachel **Gefilterter Ablaufverfolgungssatz A** als Tags angezeigt und können zudem von der Kachel entfernt werden. |
| **Optimieren** | Über diese Funktion wird der Satz der abgerufenen Ablaufverfolgungen basierend auf den Filtern, die auf den Ablaufverfolgungssatz A angewendet wurden, aktualisiert. Durch Optimieren des abgerufenen Ablaufverfolgungssatzes wird der Arbeitssatz aller abgerufenen Ablaufverfolgungen basierend auf den Filtern für den Ablaufverfolgungssatz A abgerufen. Der Arbeitssatz der abgerufenen Ablaufverfolgungen ist eine geprüfte Teilmenge aller Ablaufverfolgungen in der Gruppe. |
| **Gefilterter Ablaufverfolgungssatz B** | Bei der Erstellung ist der **gefilterte Ablaufverfolgungssatz B** eine Kopie des **gefilterten Ablaufverfolgungssatzes A.** Um die beiden Verfolgungssätze zu vergleichen, wählen Sie einen neuen Filter aus, der für den Verfolgungssatz B gilt, während der Verfolgungssatz A unverändert bleibt. Während der Anwendung der Filter werden die Anzahl der entsprechenden Ablaufverfolgungen und der Prozentsatz der Ablaufverfolgungen von der Gesamtzahl der abgerufenen Ablaufverfolgungen auf dieser Kachel berechnet. Filter werden auf der Kachel **Ablaufverfolgungssatz B** als Tags angezeigt und können zudem von der Kachel entfernt werden. |
| **Reaktionszeit Ursachenentitätspfade** | Eine Tabelle mit aufgezeichneten Entitätspfaden. X-Ray bestimmt, welcher Pfad in Ihrer Spur die wahrscheinlichste Ursache für die Reaktionszeit ist. Das Format steht für eine Hierarchie von vorgefundenen Entitäten. Dies führt zu einer Reaktionszeit-Ursache. Verwenden Sie diese Zeilen, um nach wiederkehrenden Reaktionszeitfehlern zu filtern. Weitere Informationen über das Anpassen eines Ursachenfilters und Schleusen von Daten durch die API finden Sie unter [Abrufen und Optimieren der Ursachenanalyse](https://docs.aws.amazon.com/xray/latest/devguide/xray-api-gettingdata.html#xray-api-analytics). |
| **Delta (**�**)** | Eine Spalte, die den Metriktabellen hinzugefügt wird, wenn die Ablaufverfolgungssätze A und B beide aktiv sind. In der Delta-Spalte wird der prozentuale Unterschied zwischen Ablaufverfolgungssatz A und B berechnet |
## Reaktionszeitverteilung
Die X-Ray Analytics-Konsole generiert zwei Hauptdiagramme, mit denen Sie Traces visualisieren können: **Verteilung der Reaktionszeit** und **Zeitreihenaktivität**. In diesem und den folgenden Abschnitten sehen Sie jeweils Beispiele dafür. Zudem werden die Grundlagen zum Lesen der Diagramme erläutert.
Im Folgenden sehen Sie die Farben, die dem Liniendiagramm „Reaktionszeit“ zugeordnet sind (das Zeitreihendiagramm verwendet dasselbe Farbschema):
+ **Alle Spuren in der Gruppe** — grau
+ **Abgerufene Spuren** — orange
+ **Gefilterter Trace-Satz A** — grün
+ **Gefilterter Trace-Satz B** — blau
**Example — Verteilung der Antwortzeiten**
Bei der Verteilung der Reaktionszeit handelt es sich um ein Diagramm, das die Anzahl der Ablaufverfolgungen innerhalb einer bestimmten Reaktionszeit zeigt. Klicken und ziehen Sie, um eine Auswahl innerhalb der Verteilung der Reaktionszeit zu treffen. Dadurch wird ein Filter im Arbeitssatz der Ablaufverfolgung mit der Bezeichnung `responseTime` für alle Ablaufverfolgungen innerhalb einer bestimmten Reaktionszeit ausgewählt und erstellt.
![\[Ein Diagramm, das die Verteilung der Antwortzeiten von Traces zeigt.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/analytics-responseTime.png)
## Zeitreihenaktivität
Das Diagramm „Zeitreihenaktivität“ zeigt die Anzahl der Ablaufverfolgungen in einem bestimmten Zeitraum. Die Farbindikatoren spiegeln die Farben im Liniendiagramm der Reaktionszeitverteilung wider. Je dunkler und voller der Farbblock innerhalb der Aktivitätsreihe, desto mehr Ablaufverfolgungen werden zum angegebenen Zeitpunkt dargestellt.
**Example — Aktivität in Zeitreihen**
Klicken und ziehen Sie, um im Diagramm „Zeitreihenaktivität“ eine Auswahl zu treffen. Dadurch wird ein Filter mit der Bezeichnung `timerange` im Arbeitssatz der Ablaufverfolgung für alle Ablaufverfolgungen innerhalb eines bestimmten Zeitraums ausgewählt und erstellt.
![\[Treffen Sie eine Auswahl und erstellen Sie Filter.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/analytics-timeSeries.png)
## Workflow-Beispiele
Die folgenden Beispiele zeigen allgemeine Anwendungsfälle für die X-Ray Analytics-Konsole. Jedes Beispiel zeigt eine wichtige Funktion der Konsolenumgebung. Die Beispiele folgen als Gruppe einem grundlegenden Fehlerbehebungsworkflow. In den Schritten wird beschrieben, wie Sie zunächst nicht betriebsbereite Knoten erkennen und dann mit der Analytics-Konsole interagieren, um vergleichende Abfragen automatisch zu generieren. Nachdem Sie den Bereich durch Abfragen eingegrenzt haben, sehen Sie sich abschließend die Details der für Sie relevanten Ablaufverfolgungen an, um zu ermitteln, was sich negativ auf die Integrität Ihres Services auswirkt.
## Achten Sie auf Fehler auf im Servicediagramm.
Die Trace-Map zeigt den Zustand der einzelnen Knoten an, indem sie sie anhand des Verhältnisses von erfolgreichen Aufrufen zu Fehlern und Störungen einfärbt. Ein roter Prozentsatz auf Ihrem Knoten signalisiert eine Störung. Verwenden Sie die X-Ray Analytics-Konsole, um das Problem zu untersuchen.
Weitere Informationen zum Lesen der Trace-Map finden Sie unter [Trace-Map anzeigen](https://docs.aws.amazon.com/xray/latest/devguide/xray-console.html#xray-console-servicemap).
![\[Eine Störung beobachten\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/scorekeep-gettingstarted-servicemap-before-2021.png)
## Spitzen der Reaktionszeit erkennen
Mithilfe der Reaktionszeitverteilung können Sie Spitzen in der Reaktionszeit beobachten. Durch die Auswahl der Spitzen in der Reaktionszeit werden die Tabellen unterhalb der Diagramme aktualisiert und enthalten dann alle zugehörigen Metriken, z. B. die Statuscodes.
Wenn Sie klicken und ziehen, wählt X-Ray einen Filter aus und erstellt ihn. Er wird in einem grauen Schatten über den grau unterlegten Linien dargestellt. Sie können diesen Schatten jetzt entlang der Verteilung nach links und rechts ziehen, um die Auswahl und den Filter zu aktualisieren.
![\[Treffen Sie eine Auswahl und erstellen Sie Filter.\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/analytics-showFilterf.png)
## Alle Ablaufverfolgungen mit einem Statuscode anzeigen
Sie können Ablaufverfolgungen innerhalb der ausgewählten Spitze anhand der Metriktabellen unterhalb der Diagramme detailliert anzeigen. Durch Klicken auf eine Zeile in der Tabelle **HTTP STATUS CODE (HTTP-STATUSCODE** können Sie automatisch einen Filter im Arbeitsdatensatz erstellen. Beispiel: Sie können alle Ablaufverfolgungen für Statuscode 500 anzeigen. Dadurch wird ein Filter-Tag auf der Kachel „Ablaufverfolgungssatz“ mit dem Namen `http.status` erstellt.
## Alle Elemente in einer Untergruppe und einem Benutzer zugeordnete Elemente anzeigen
Führen Sie einen Drilldown in den Fehler auf Grundlage von Benutzer, URL, Ursache Reaktionszeit oder anderen vordefinierten Attributen durch. Wenn Sie beispielsweise den Satz der Ablaufverfolgungen mit Statuscode 500 filtern möchten, wählen Sie eine Zeile aus der Tabelle **USERS (BENUTZER)** aus. Dies führt zu zwei Filter-Tags auf der Kachel „Ablaufverfolgungssatz“: `http.status`, wie zuvor festgelegt, und `user`.
## Vergleichen Sie zwei Ablaufverfolgungssätze mit unterschiedlichen Kriterien
Vergleichen Sie verschiedene Benutzer und ihre POST-Anfragen, um weitere Abweichungen und Korrelationen zu finden. Wenden Sie Ihren ersten Satz Filter an. Sie sind anhand einer blauen Linie in der Reaktionszeitverteilung definiert. Wählen Sie dann **Compare (Vergleichen)** aus. Zu Beginn wird dadurch eine Kopie der Filter im Ablaufverfolgungssatz A erstellt.
Um fortzufahren, definieren Sie einen neuen Satz Filter, die auf Ablaufverfolgungssatz B angewendet werden. Dieser zweite Satz wird durch eine grüne Linie dargestellt. Das folgende Beispiel zeigt die verschiedenen Linien entsprechend dem blauen und grünen Farbschema.
![\[Liniendiagramm-Vergleich\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/analytics-compareLines.png)
## Zeigen Sie Details einer interessanten Ablaufverfolgung an
Wenn Sie mithilfe der Konsolenfilter den Umfang eingrenzen, erhält die Ablaufverfolgungsliste unterhalb der Metriktabellen mehr Bedeutung. Die Tabelle mit der Ablaufverfolgungsliste vereint Informationen über **URL**, **USER (BENUTZER)** und **STATUS CODE (STATUSCODE)** in einer Ansicht. Weitere Einblicke erhalten Sie, wenn Sie eine Zeile aus dieser Tabelle auswählen und so die Detailseite der Ablaufverfolgung öffnen und die Zeitleiste und Rohdaten anzeigen.
# Gruppen konfigurieren
Gruppen sind eine Sammlung von Ablaufverfolgungen, die durch einen Filterausdruck definiert sind. Sie können Gruppen verwenden, um zusätzliche Servicegraphen zu erstellen und CloudWatch Amazon-Metriken bereitzustellen. Sie können die AWS X-Ray Konsole oder die X-Ray-API verwenden, um Gruppen für Ihre Dienste zu erstellen und zu verwalten. In diesem Thema wird beschrieben, wie Gruppen mithilfe der X-Ray-Konsole erstellt und verwaltet werden. Informationen zur Verwaltung von Gruppen mithilfe der X-Ray-API finden Sie unter[Gruppen](xray-api-configuration.md#xray-api-configuration-groups).
Sie können Gruppen von Traces für Trace-Maps, Traces oder Analysen erstellen. Wenn Sie eine Gruppe erstellen, ist die Gruppe als Filter im Gruppen-Dropdownmenü auf allen drei Seiten verfügbar: **Trace Map**, **Traces** und **Analytics**.
![\[Gruppen-Menü\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/group-menu.png)
Gruppen werden über ihren Namen oder einen Amazon-Ressourcennamen (ARN) identifiziert und enthalten einen Filterausdruck. Der Service vergleicht eingehende Ablaufverfolgungen mit dem Ausdruck und speichert sie entsprechend. Weitere Hinweise zum Erstellen eines Filterausdrucks finden Sie unter[Verwenden von Filterausdrücken](xray-console-filters.md).
Durch das Aktualisieren des Filterausdrucks einer Gruppe werden die bereits aufgezeichneten Daten nicht geändert. Die Aktualisierung gilt nur für nachfolgende Ablaufverfolgungen. Dies kann dazu führen, dass im Diagramm neue und alte Ausdrücke zusammengeführt werden. Um dies zu vermeiden, löschen Sie eine aktuelle Gruppe und erstellen Sie eine neue.
**Anmerkung**
Gruppen werden anhand der Anzahl der abgerufenen Ablaufverfolgungen, die dem Filterausdruck entsprechen, in Rechnung gestellt. Weitere Informationen finden Sie unter [AWS X-Ray Preise](https://aws.amazon.com/xray/pricing/).
**Topics**
+ [Erstellen einer Gruppe](#xray-console-group-create-console)
+ [Wenden Sie eine Gruppe an](#xray-console-group-apply)
+ [Bearbeiten Sie eine Gruppe](#xray-console-group-edit)
+ [Eine Gruppe klonen](#xray-console-group-clone)
+ [Löschen einer Gruppe](#xray-console-group-delete)
+ [Gruppenmetriken in Amazon anzeigen CloudWatch](#xray-console-group-cloudwatch)
## Erstellen einer Gruppe
**Anmerkung**
Sie können jetzt X-Ray-Gruppen von der CloudWatch Amazon-Konsole aus konfigurieren. Sie können die X-Ray-Konsole auch weiterhin verwenden.
------
#### [ CloudWatch console ]
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Wählen Sie im linken Navigationsbereich **Einstellungen** aus.
1. Wählen Sie im Bereich **X-Ray-Traces** unter **Gruppen** die Option **Einstellungen anzeigen**.
1. Wählen Sie oberhalb der **Gruppenliste die Option Gruppe erstellen** aus.
1. Geben Sie auf der Seite **Gruppe erstellen** einen Namen für die Gruppe ein. Ein Gruppenname kann maximal 32 Zeichen lang sein und alphanumerische Zeichen und Bindestriche enthalten. Bei Gruppennamen wird zwischen Groß- und Kleinschreibung unterschieden.
1. Geben Sie einen Filterausdruck ein. Weitere Informationen zum Erstellen eines Filterausdrucks finden Sie unter[Verwenden von Filterausdrücken](xray-console-filters.md). Im folgenden Beispiel filtert die Gruppe nach Fehlerspuren vom Dienst `api.example.com` und nach Anfragen an den Dienst, bei denen die Antwortzeit mindestens fünf Sekunden betrug.
```
fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
```
1. Aktivieren oder deaktivieren Sie in **Insights** den Insights-Zugriff für die Gruppe. Weitere Informationen über Funde sind unter [Nutzung von X-Ray Insights](xray-console-insights.md) verfügbar.
![\[Kontrollkästchen für Einblicke auf der Gruppenseite\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/group-insights-cw.png)
1. Wählen Sie **unter Tags** die Option **Neues Tag hinzufügen** aus, um einen Tag-Schlüssel und optional einen Tag-Wert einzugeben. Fügen Sie nach Bedarf weitere Tags hinzu. Tag-Schlüssel müssen eindeutig sein. Um ein Tag zu löschen, wählen Sie unter jedem Tag die Option **Entfernen** aus. Weitere Informationen zu Tags erhalten Sie unter [Kennzeichnen von Regeln und Gruppen für die Röntgenprobenahme](xray-tagging.md).
![\[Tag-Felder auf der Gruppenseite\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/group-tags-cw.png)
1. Wählen Sie **Create group** (Gruppe erstellen) aus.
------
#### [ X-Ray console ]
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die X-Ray-Konsole zu [https://console.aws.amazon.com/xray/Hause](https://console.aws.amazon.com/xray/home).
1. Öffnen **Sie die Seite Gruppe erstellen** über die **Gruppenseite** im linken Navigationsbereich oder über das Gruppenmenü auf einer der folgenden Seiten: **Trace Map**, **Traces** und **Analytics**.
1. Geben Sie auf der Seite **Gruppe erstellen** einen Namen für die Gruppe ein. Ein Gruppenname kann maximal 32 Zeichen lang sein und alphanumerische Zeichen und Bindestriche enthalten. Bei Gruppennamen wird zwischen Groß- und Kleinschreibung unterschieden.
1. Geben Sie einen Filterausdruck ein. Weitere Informationen zum Erstellen eines Filterausdrucks finden Sie unter[Verwenden von Filterausdrücken](xray-console-filters.md). Im folgenden Beispiel filtert die Gruppe nach Fehlerspuren vom Dienst `api.example.com` und nach Anfragen an den Dienst, bei denen die Antwortzeit mindestens fünf Sekunden betrug.
```
fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
```
1. Aktivieren oder deaktivieren Sie in **Insights** den Insights-Zugriff für die Gruppe. Weitere Informationen über Funde sind unter [Nutzung von X-Ray Insights](xray-console-insights.md) verfügbar.
![\[Kontrollkästchen für Einblicke auf der Gruppenseite\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/group-insights.png)
1. Geben Sie im Feld **Tags** einen Tag-Schlüssel und optional einen Tag-Wert ein. Wenn Sie ein Tag hinzufügen, wird eine neue Zeile angezeigt, in der Sie ein anderes Tag eingeben können. Tag-Schlüssel müssen eindeutig sein. Um ein Tag zu löschen, wählen Sie **X** am Ende der Tag-Zeile aus. Weitere Informationen zu Tags erhalten Sie unter [Kennzeichnen von Regeln und Gruppen für die Röntgenprobenahme](xray-tagging.md).
![\[Tag-Felder auf der Gruppenseite\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/group-tags.png)
1. Wählen Sie **Create group** (Gruppe erstellen) aus.
------
## Wenden Sie eine Gruppe an
------
#### [ CloudWatch console ]
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Öffnen Sie im Navigationsbereich unter **X-Ray Traces** eine der folgenden Seiten:
+ **Trace-Map**
+ **Ablaufverfolgungen**
1. Geben Sie einen Gruppennamen in den **Gruppenfilter Filter by X-Ray** ein. Die auf der Seite angezeigten Daten ändern sich entsprechend dem in der Gruppe festgelegten Filterausdruck.
------
#### [ X-Ray console ]
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die X-Ray-Konsole zu [https://console.aws.amazon.com/xray/Hause](https://console.aws.amazon.com/xray/home).
1. Öffnen Sie im Navigationsbereich eine der folgenden Seiten:
+ **Karte verfolgen**
+ **Ablaufverfolgungen**
+ **Analysen**
1. Wählen Sie im Gruppenmenü die Gruppe aus, in der Sie erstellt haben[Erstellen einer Gruppe](#xray-console-group-create-console). Die auf der Seite angezeigten Daten ändern sich entsprechend dem in der Gruppe festgelegten Filterausdruck.
------
## Bearbeiten Sie eine Gruppe
------
#### [ CloudWatch console ]
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Wählen Sie im linken Navigationsbereich **Einstellungen** aus.
1. Wählen Sie im Bereich **X-Ray-Traces** unter **Gruppen** die Option **Einstellungen anzeigen**.
1. Wählen Sie im Bereich **Gruppen** eine Gruppe aus und klicken Sie dann auf **Bearbeiten**.
1. Sie können eine Gruppe zwar nicht umbenennen, aber Sie können den Filterausdruck aktualisieren. Weitere Informationen zum Erstellen eines Filterausdrucks finden Sie unter[Verwenden von Filterausdrücken](xray-console-filters.md). Im folgenden Beispiel filtert die Gruppe nach Fehlerablaufverfolgungen des Dienstes`api.example.com`, bei dem die URL-Adresse der Anfrage Folgendes enthält`example/game`: Die Antwortzeit für Anfragen betrug mindestens fünf Sekunden.
```
fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
```
1. Aktivieren oder deaktivieren Sie in **Insights** den Insights-Zugriff für die Gruppe. Weitere Informationen über Funde sind unter [Nutzung von X-Ray Insights](xray-console-insights.md) verfügbar.
![\[Kontrollkästchen für Einblicke auf der Gruppenseite\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/group-insights-cw.png)
1. Wählen Sie **unter Tags** die Option **Neues Tag hinzufügen** aus, um einen Tag-Schlüssel und optional einen Tag-Wert einzugeben. Fügen Sie nach Bedarf weitere Tags hinzu. Tag-Schlüssel müssen eindeutig sein. Um ein Tag zu löschen, wählen Sie unter jedem Tag die Option **Entfernen** aus. Weitere Informationen zu Tags erhalten Sie unter [Kennzeichnen von Regeln und Gruppen für die Röntgenprobenahme](xray-tagging.md).
![\[Tag-Felder auf der Gruppenseite\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/group-tags-cw.png)
1. Wenn Sie mit dem Aktualisieren der Gruppe fertig sind, wählen Sie **Gruppe aktualisieren**.
------
#### [ X-Ray console ]
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die X-Ray-Konsole zu [https://console.aws.amazon.com/xray/Hause](https://console.aws.amazon.com/xray/home).
1. Gehen Sie wie folgt vor, um die Seite **Gruppe bearbeiten** zu öffnen.
1. Wählen Sie auf der Seite **Gruppen** den Namen einer Gruppe aus, um sie zu bearbeiten.
1. Zeigen Sie im Gruppenmenü auf einer der folgenden Seiten auf eine Gruppe, und wählen Sie dann **Bearbeiten** aus.
+ **Karte verfolgen**
+ **Ablaufverfolgungen**
+ **Analysen**
1. Sie können eine Gruppe zwar nicht umbenennen, aber Sie können den Filterausdruck aktualisieren. Weitere Informationen zum Erstellen eines Filterausdrucks finden Sie unter[Verwenden von Filterausdrücken](xray-console-filters.md). Im folgenden Beispiel filtert die Gruppe nach Fehlerablaufverfolgungen des Dienstes`api.example.com`, bei dem die URL-Adresse der Anfrage Folgendes enthält`example/game`: Die Antwortzeit für Anfragen betrug mindestens fünf Sekunden.
```
fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
```
1. **Aktivieren oder deaktivieren Sie in Insights Insights und Insights-Benachrichtigungen für die Gruppe.** Weitere Informationen über Funde sind unter [Nutzung von X-Ray Insights](xray-console-insights.md) verfügbar.
![\[Kontrollkästchen für Einblicke auf der Gruppenseite\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/group-insights.png)
1. Bearbeiten Sie **unter Tags** die Tag-Schlüssel und -Werte. Tag-Schlüssel müssen eindeutig sein. Tag-Werte sind optional; Sie können Werte löschen, wenn Sie möchten. Um ein Tag zu löschen, wählen Sie **X** am Ende der Tagzeile aus. Weitere Informationen zu Tags erhalten Sie unter [Kennzeichnen von Regeln und Gruppen für die Röntgenprobenahme](xray-tagging.md).
![\[Tag-Felder auf der Gruppenseite\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/group-tags.png)
1. Wenn Sie mit dem Aktualisieren der Gruppe fertig sind, wählen Sie **Gruppe aktualisieren**.
------
## Eine Gruppe klonen
Durch das Klonen einer Gruppe wird eine neue Gruppe erstellt, die den Filterausdruck und die Tags einer vorhandenen Gruppe enthält. Wenn Sie eine Gruppe klonen, hat die neue Gruppe denselben Namen wie die Gruppe, aus der sie geklont wurde, wobei der Name an den Namen `-clone` angehängt wird.
------
#### [ CloudWatch console ]
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudWatch Konsole unter. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)
1. Wählen Sie im linken Navigationsbereich **Einstellungen** aus.
1. Wählen Sie im Bereich **X-Ray-Traces** unter **Gruppen** die Option **Einstellungen anzeigen**.
1. Wählen Sie im Bereich **Gruppen** eine Gruppe aus und klicken Sie dann auf **Klonen**.
1. Auf der Seite **Gruppe erstellen** lautet der Name der Gruppe *group-name*`-clone`. Geben Sie optional einen neuen Namen für die Gruppe ein. Ein Gruppenname kann maximal 32 Zeichen lang sein und alphanumerische Zeichen und Bindestriche enthalten. Bei Gruppennamen wird zwischen Groß- und Kleinschreibung unterschieden.
1. Sie können den Filterausdruck aus der vorhandenen Gruppe beibehalten oder optional einen neuen Filterausdruck eingeben. Weitere Informationen zum Erstellen eines Filterausdrucks finden Sie unter[Verwenden von Filterausdrücken](xray-console-filters.md). Im folgenden Beispiel filtert die Gruppe nach Fehlerspuren vom Dienst `api.example.com` und nach Anfragen an den Dienst, bei denen die Antwortzeit mindestens fünf Sekunden betrug.
```
service("api.example.com") { fault = true OR responsetime >= 5 }
```
1. Bearbeiten Sie **unter Tags** die Tag-Schlüssel und -Werte, falls erforderlich. Tag-Schlüssel müssen eindeutig sein. Tag-Werte sind optional; Sie können Werte löschen, wenn Sie möchten. Um ein Tag zu löschen, wählen Sie **X** am Ende der Tagzeile aus. Weitere Informationen zu Tags erhalten Sie unter [Kennzeichnen von Regeln und Gruppen für die Röntgenprobenahme](xray-tagging.md).
1. Wählen Sie **Create group** (Gruppe erstellen) aus.
------
#### [ X-Ray console ]
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die X-Ray-Konsole zu [https://console.aws.amazon.com/xray/Hause](https://console.aws.amazon.com/xray/home).
1. Öffnen Sie im linken Navigationsbereich die **Gruppenseite** und wählen Sie dann den Namen der Gruppe aus, die Sie klonen möchten.
1. Wählen Sie im Menü **Aktionen** die Option **Gruppe klonen** aus.
1. Auf der Seite **Gruppe erstellen** lautet der Name der Gruppe *group-name*`-clone`. Geben Sie optional einen neuen Namen für die Gruppe ein. Ein Gruppenname kann maximal 32 Zeichen lang sein und alphanumerische Zeichen und Bindestriche enthalten. Bei Gruppennamen wird zwischen Groß- und Kleinschreibung unterschieden.
1. Sie können den Filterausdruck aus der vorhandenen Gruppe beibehalten oder optional einen neuen Filterausdruck eingeben. Weitere Informationen zum Erstellen eines Filterausdrucks finden Sie unter[Verwenden von Filterausdrücken](xray-console-filters.md). Im folgenden Beispiel filtert die Gruppe nach Fehlerspuren vom Dienst `api.example.com` und nach Anfragen an den Dienst, bei denen die Antwortzeit mindestens fünf Sekunden betrug.
```
service("api.example.com") { fault = true OR responsetime >= 5 }
```
1. Bearbeiten Sie **unter Tags** die Tag-Schlüssel und -Werte, falls erforderlich. Tag-Schlüssel müssen eindeutig sein. Tag-Werte sind optional; Sie können Werte löschen, wenn Sie möchten. Um ein Tag zu löschen, wählen Sie **X** am Ende der Tagzeile aus. Weitere Informationen zu Tags erhalten Sie unter [Kennzeichnen von Regeln und Gruppen für die Röntgenprobenahme](xray-tagging.md).
1. Wählen Sie **Create group** (Gruppe erstellen) aus.
------
## Löschen einer Gruppe
Folgen Sie den Schritten in diesem Abschnitt, um eine Gruppe zu löschen. Sie können die **Standardgruppe** nicht löschen.
------
#### [ CloudWatch console ]
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Wählen Sie im linken Navigationsbereich **Einstellungen** aus.
1. Wählen Sie im Bereich **X-Ray-Traces** unter **Gruppen** die Option **Einstellungen anzeigen**.
1. Wählen Sie im Bereich **Gruppen** eine Gruppe aus und klicken Sie dann auf **Löschen**.
1. Wenn Sie zur Bestätigung aufgefordert werden, wählen Sie **Löschen**.
------
#### [ X-Ray console ]
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die X-Ray-Konsole zu [https://console.aws.amazon.com/xray/Hause](https://console.aws.amazon.com/xray/home).
1. Öffnen Sie im linken Navigationsbereich die **Gruppenseite** und wählen Sie dann den Namen der Gruppe aus, die Sie löschen möchten.
1. Wählen Sie im Menü **Aktionen** die Option **Gruppe löschen** aus.
1. Wenn Sie zur Bestätigung aufgefordert werden, wählen Sie **Löschen**.
------
## Gruppenmetriken in Amazon anzeigen CloudWatch
Nachdem eine Gruppe erstellt wurde, werden eingehende Traces mit dem Filterausdruck der Gruppe verglichen, während sie im X-Ray-Dienst gespeichert werden. Metriken für die Anzahl der Traces, die den einzelnen Kriterien entsprechen, werden CloudWatch jede Minute auf Amazon veröffentlicht. Wenn Sie auf der Seite **Gruppe bearbeiten die Option** **Metrik anzeigen** wählen, wird in der CloudWatch Konsole die Seite **Metrik** geöffnet. Weitere Informationen zur Verwendung von CloudWatch Metriken finden Sie unter [Using Amazon CloudWatch Metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) im * CloudWatch Amazon-Benutzerhandbuch*.
------
#### [ CloudWatch console ]
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Wählen Sie im linken Navigationsbereich **Einstellungen** aus.
1. Wählen Sie im Bereich **X-Ray-Traces** unter **Gruppen** die Option **Einstellungen anzeigen**.
1. Wählen Sie im Bereich **Gruppen** eine Gruppe aus und klicken Sie dann auf **Bearbeiten**.
1. Wählen Sie auf der Seite **„Gruppe bearbeiten**“ die Option **Metrik anzeigen** aus.
Die Seite **Metriken** der CloudWatch Konsole wird auf einer neuen Registerkarte geöffnet.
------
#### [ X-Ray console ]
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die X-Ray-Konsole zu [https://console.aws.amazon.com/xray/Hause](https://console.aws.amazon.com/xray/home).
1. Öffnen Sie im linken Navigationsbereich die **Gruppenseite** und wählen Sie dann den Namen einer Gruppe aus, für die Sie Messwerte anzeigen möchten.
1. Wählen Sie auf der Seite **„Gruppe bearbeiten**“ die Option **Metrik anzeigen** aus.
Die Seite **Metriken** der CloudWatch Konsole wird auf einer neuen Registerkarte geöffnet.
------
# Konfigurieren von -Samplingregeln
Sie können die AWS X-Ray Konsole verwenden, um Sampling-Regeln für Ihre Dienste zu konfigurieren. Das AWS Distro for OpenTelemetry, das X-Ray SDK und AWS-Services das [Active Tracing](xray-services.md) mit Sampling-Konfigurationen unterstützen, verwenden Sampling-Regeln, um zu bestimmen, welche Anfragen aufgezeichnet werden sollen.
**Topics**
+ [Konfigurieren von -Samplingregeln](#xray-console-config)
+ [Anpassen von Samplingregeln](#xray-console-custom)
+ [Optionen für Samplingregeln](#xray-console-sampling-options)
+ [Beispiele für Samplingregeln](#xray-console-sampling-examples)
+ [Konfigurieren Ihres Service für die Verwendung von Samplingregeln](#xray-console-sampling-service)
+ [Anzeigen von Samplingergebnissen](#xray-console-sampling-results)
+ [Nächste Schritte](#xray-console-sampling-nextsteps)
## Konfigurieren von -Samplingregeln
Sie können Sampling für die folgenden Anwendungsfälle konfigurieren:
+ **API Gateway Entrypoint** — 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ür AWS X-Ray](xray-services-apigateway.md).
+ **AWS AppSync**— AWS AppSync unterstützt Sampling und aktives Tracing. Informationen zum Aktivieren der aktiven Ablaufverfolgung für AWS AppSync Anfragen finden Sie unter [Tracing with AWS X-Ray](https://docs.aws.amazon.com/appsync/latest/devguide/x-ray-tracing.html).
+ **AWS Step Functions**— AWS Step Functions unterstützt Sampling und aktives Tracing. Informationen zur Aktivierung der aktiven Ablaufverfolgung auf AWS Step Functions Zustandsmaschinen finden Sie unter [X-Ray Tracing in Step Functions](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-xray-tracing.html).
+ **Instrument AWS Distro for OpenTelemetry on Compute-Plattformen** — Bei der Verwendung von Rechenplattformen wie Amazon EC2, Amazon ECS oder wird Sampling unterstützt AWS Elastic Beanstalk, wenn die Anwendung mit dem neuesten AWS Distro for OpenTelemetry - oder X-Ray-SDK instrumentiert wurde.
## Anpassen von Samplingregeln
Durch die Anpassung der Stichprobenregeln können Sie die Menge der aufgenommenen Daten kontrollieren. Sie können auch das Sampling-Verhalten ändern, ohne Ihren Code zu ändern oder erneut bereitzustellen. Sampling-Regeln teilen dem AWS Distro for OpenTelemetry (ADOT) oder X-Ray SDK mit, wie viele Anfragen für eine Reihe von Kriterien aufgezeichnet werden müssen. Standardmäßig zeichnet das 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 in Ihren Code einbinden. 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.
Indem Sie Sampling-Regeln in der X-Ray-Konsole definieren und [das SDK so konfigurieren](#xray-console-sampling-service), dass es Regeln aus dem X-Ray-Dienst liest, 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**
Bei der Konfiguration von Probenahmeregeln ist es wichtig zu wissen, dass die Röntgenprobenentnahme „übergeordnetes System“ ist. Das bedeutet, dass die Stichprobenentscheidung nur einmal getroffen wird, in der Regel vom ersten X-Ray-enabled Dienst, der die Anfrage bearbeitet (der „Root“ -Dienst).
Wenn ein nachgelagerter Dienst eine Anfrage erhält, für die bereits eine Stichprobenentscheidung von einem übergeordneten Dienst getroffen wurde, wird er diese Entscheidung unabhängig von seinen eigenen Stichprobenregeln berücksichtigen.
Wenn Regeln gelten: Ihre benutzerdefinierten Stichprobenregeln gelten nur für Dienste, für die noch keine Stichprobenentscheidung getroffen wurde. Dies gilt normalerweise für:
Der Einstiegspunkt Ihrer Anwendung (z. B. ein API Gateway, ein Load Balancer oder der erste instrumentierte Microservice).
Asynchrone Prozesse oder Worker, die einen brandneuen Trace starten.
Häufiger Fallstrick: Wenn Sie eine strenge Stichprobenregel für „Service B“ erstellen, „Service B“ aber immer von „Service A“ aufgerufen wird, wird Ihre Regel für Service B wahrscheinlich nie angewendet, da sie einfach der Entscheidung von Service A folgt. Um die Stichprobenziehung von Traces für diesen Workflow zu ändern, müssen Sie die Stichprobenregel für den Root-Dienst (Service A) konfigurieren.
**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 genau den konfigurierten Abtastregeln. Im Laufe der Zeit sollte die Anzahl der gesampelten Anfragen jedoch in der Nähe des konfigurierten Prozentsatzes liegen.
Sie können jetzt X-Ray-Sampling-Regeln von der CloudWatch Amazon-Konsole aus konfigurieren.
**Um Sampling-Regeln in der CloudWatch Konsole zu konfigurieren**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Wählen Sie im linken Navigationsbereich unter **Setup** die Option **Einstellungen** aus.
1. Wählen Sie im Bereich **X-Ray-Traces** unter **Sampling-Regeln** die Option **Einstellungen anzeigen**.
1. 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 und klicken Sie auf **Bearbeiten**, um sie zu bearbeiten.
Um eine Regel zu löschen, wählen Sie eine Regel aus und wählen Sie **Löschen**, um sie 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 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 die feste Rate 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.
+ **Dienstname** (Zeichenfolge) — Der Name des instrumentierten Dienstes, wie er in der Trace-Map angezeigt wird.
+ X-Ray SDK — Der Dienstname, den Sie auf dem Rekorder konfigurieren.
+ Amazon API Gateway —`api-name/stage`.
+ **Servicetyp** (Zeichenfolge) — Der Servicetyp, wie er in der Trace-Map angezeigt wird. Legen Sie für das X-Ray SDK den Diensttyp fest, indem Sie das entsprechende Plugin anwenden:
+ `AWS::ElasticBeanstalk::Environment`— Eine AWS Elastic Beanstalk Umgebung (Plugin).
+ `AWS::EC2::Instance`— Eine EC2 Amazon-Instanz (Plugin).
+ `AWS::ECS::Container`— Ein Amazon ECS-Container (Plugin).
+ `AWS::EKS::Container`— Ein Amazon EKS-Container (Plugin).
+ `AWS::APIGateway::Stage`— Eine Amazon API Gateway Gateway-Phase.
+ `AWS::AppSync::GraphQLAPI `— Eine AWS AppSync API-Anfrage.
+ `AWS::StepFunctions::StateMachine`— Eine AWS Step Functions Zustandsmaschine.
+ **Host** (string) — Der Hostname aus dem HTTP-Host-Header.
+ **HTTP-Methode** (Zeichenfolge) — Die Methode der HTTP-Anfrage.
+ **URL-Pfad** (Zeichenfolge) — Der URL-Pfad der Anfrage.
+ X-Ray SDK — Der Pfadteil der HTTP-Anforderungs-URL.
+ **Ressourcen-ARN** (Zeichenfolge) — Der ARN der AWS Ressource, auf der der Dienst ausgeführt wird.
+ 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.
+ (Optional) **Attribute** (Schlüssel und Wert) — Segmentattribute, die bekannt sind, als die Stichprobenentscheidung getroffen wurde.
+ X-Ray SDK — Nicht unterstützt. Das SDK ignoriert Regeln, die Attribute angeben.
+ Amazon API Gateway — Header aus der ursprünglichen HTTP-Anfrage.
+ (Optional) **SamplingRateBoost**(Objekt) — Steuert das anomaliebedingte Boost-Verhalten bei der Probennahme.
+ MaxRate (Ganzzahl zwischen 0 und 100) — Die maximale Probenahmerate (0,0—1,0) X-Ray bei Anomalien bis zu einem Grad ansteigen
+ CooldownWindowMinutes (Ganzzahl größer als 0) — Zeitfenster (Minuten), in dem nur ein Boost ausgelöst werden kann, wodurch kontinuierliche Boosts verhindert werden
## Beispiele für Samplingregeln
**Example — 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**
+ **Rate**: **5** (**0.05**falls mit einem JSON-Dokument konfiguriert)
**Example — Debugging-Regel zur Verfolgung 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**
+ **Reservoir**: **1**
+ **Rate**: **100** (**1**falls mit einem JSON-Dokument konfiguriert)
+ **Name des Dienstes**: **Scorekeep**
+ **Service type (Servicetyp):** **\$1**
+ **Gastgeber**: **\$1**
+ **HTTP-Methode**: **PUT**
+ **URL-Pfad**: **/history/\$1**
+ **Ressourcen-ARN**: **\$1**
**Example — Höherer Mindestsatz für POSTs**
+ **Name der Regel**: **POST minimum**
+ **Priorität**: **100**
+ **Reservoir**: **10**
+ **Rate**: **10** (**.1**falls mit einem JSON-Dokument konfiguriert)
+ **Name des Dienstes**: **\$1**
+ **Service type (Servicetyp):** **\$1**
+ **Gastgeber**: **\$1**
+ **HTTP-Methode**: **POST**
+ **URL-Pfad**: **\$1**
+ **Ressourcen-ARN**: **\$1**
**Example Aktivieren Sie den durch Anomalien verursachten Boost**
Konfiguriere eine Regel, die bei Anomalien einen Sampling-Boost von bis zu 50% mit einer Abklingzeit von 10 Minuten auslöst.
+ **Name der Regel:** **MyAdaptiveRule**
+ **Priorität**: **100**
+ **Reservoir**: **1**
+ **FixedRate**: **0.0510**
+ **Name des Dienstes**: **\$1**
+ **Service type (Servicetyp):** **\$1**
+ **Gastgeber**: **\$1**
+ **HTTP-Methode**: **POST**
+ **URL-Pfad**: **\$1**
+ **maximale Rate**: **0.5**
+ **cooldownWindowMinutes**: **10**
## Konfigurieren Ihres Service für die Verwendung von Samplingregeln
Das SDK für AWS Distro for OpenTelemetry (ADOT) und X-Ray 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: [Verwendung von X-Ray Remote Sampling](https://aws-otel.github.io/docs/getting-started/java-sdk/auto-instr#using-x-ray-remote-sampling) mit ADOT Java
+ Go: [Sampling mit ADOT Go konfigurieren](https://aws-otel.github.io/docs/getting-started/go-sdk/manual-instr#configuring-sampling)
+ Node.js: [Verwendung von X-Ray Remote Sampling](https://aws-otel.github.io/docs/getting-started/js-sdk/trace-metric-auto-instr#using-x-ray-remote-sampling) mit ADOT JavaScript
+ Python: [Verwendung von X-Ray Remote Sampling](https://aws-otel.github.io/docs/getting-started/python-sdk/auto-instr#using-x-ray-remote-sampling) mit ADOT Python
+ Rubin: [Regeln für die Probenahme](xray-sdk-ruby-configuration.md#xray-sdk-ruby-configuration-sampling)
+ .NET: [Verwendung von X-Ray Remote Sampling](https://aws-otel.github.io/docs/getting-started/dotnet-sdk/auto-instr#using-x-ray-remote-sampling) mit ADOT .NET
Informationen zu API Gateway finden Sie unter[Unterstützung für aktives Tracing von Amazon API Gateway für AWS X-Ray](xray-services-apigateway.md).
## Anzeigen von Samplingergebnissen
Auf der **Sampling-Seite** der X-Ray-Konsole finden Sie 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**
+ **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 gesammelten Anfragen**: Die Anzahl der aufgezeichneten Anfragen.
+ **Stichprobe mit fester Rate**: Die Anzahl der Anfragen, bei denen die feste Rate der Regel angewendet wurde.
+ **Mit Reservoirlimit abgetastet**: Die Anzahl der Anfragen, die unter Verwendung einer von X-Ray zugewiesenen Quote abgetastet wurden.
+ **Aus dem Reservoir ausgeliehen**: Die Anzahl der Anfragen, die durch Entleihen aus dem Reservoir entnommen 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 Dienst eine Spur pro Sekunde aus, bis X-Ray eine Quote zuweist.
Weitere Informationen zu Samplingstatistiken und dazu, wie Services Samplingregeln verwenden, finden Sie unter [Verwenden von Sampling-Regeln mit der X-Ray-API](xray-api-sampling.md).
## Nächste Schritte
Sie können die X-Ray-API verwenden, um Sampling-Regeln 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 [Konfiguration von Sampling-, Gruppen- und Verschlüsselungseinstellungen mit der AWS X-Ray API](xray-api-configuration.md).
Das AWS Distro for OpenTelemetry, das X-Ray SDK und AWS-Services die X-Ray-API verwenden, um Probenahmeregeln zu lesen, Probenahmeergebnisse zu melden und Probenahmeziele abzurufen. Services müssen verfolgen, wie oft sie die einzelnen Regeln anwenden, Regeln anhand ihrer Priorität auswerten 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 Sampling-Regeln mit der X-Ray-API](xray-api-sampling.md).
Wenn die AWS Distribution for OpenTelemetry oder das X-Ray SDK Sampling aufrufen APIs, verwenden sie den CloudWatch Agenten als Proxy. Wenn Sie bereits den TCP-Port 2000 verwenden, können Sie den Agenten so konfigurieren, dass er den Proxy auf einem anderen Port ausführt. Einzelheiten finden Sie in der [Installationsanleitung für den CloudWatch Agenten](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html).
# Konfiguration der adaptiven Probenahme
Das Fehlen kritischer Spuren bei Anomaliespitzen kann die Ursachenanalyse erschweren. Die Aufrechterhaltung hoher Probenraten ist jedoch teuer. Die adaptive Röntgenprobenentnahme bietet einen vollständigen Überblick über Anomalien und kontrolliert die Kosten während des normalen Betriebs. Bei der adaptiven Abtastung legen Sie eine maximale Abtastrate fest, und X-Ray passt sich automatisch innerhalb dieser Grenze an. X-Ray berechnet den minimalen Boost, der zur Erfassung von Fehlerspuren erforderlich ist. Wenn Ihre Basisrate genügend Daten erfasst, erfolgt kein Boost. Sie zahlen nur für zusätzliche Probenahmen, wenn sie benötigt werden.
Vorteile der adaptiven Probenahme:
+ Vollständige Transparenz bei Vorfällen — Verschaffen Sie sich vollständige Nachverfolgbarkeit von Vorfällen ohne manuelles Eingreifen. X-Ray passt die Abtastraten automatisch an, um Fehlerspuren zu erfassen, und kehrt dann zu normalen Raten zurück.
+ Sichtbarkeit der Ursache — Erkennen Sie stets die Ursache von Problemen. X-Ray erfasst kritische Fehlerdaten, auch wenn keine vollständige Spurenprobenahme ausgelöst wird.
+ Kosten optimieren — Kurzfristige Probenahmen (bis zu 1 Minute) und automatische Abklingzeiten verhindern eine Überprobennahme. Sie zahlen nur für die Daten, die Sie zur Problemdiagnose benötigen.
**Topics**
+ [Unterstützte Plattformen SDKs und Plattformen](#adaptive-sampling-supported-sdks)
+ [Wählen Sie Ihren adaptiven Sampling-Ansatz](#adaptive-sampling-features)
+ [Lokale SDK-Konfiguration](#local-sdk-configuration)
## Unterstützte Plattformen SDKs und Plattformen
**Unterstütztes SDK** — Adaptive Sampling erfordert die neueste Version des ADOT SDK.
**Unterstützte Sprache** — Java (Version [v2.11.5](https://github.com/aws-observability/aws-otel-java-instrumentation/releases/tag/v2.11.5) oder höher)
Ihre Anwendung muss mit dem unterstützten ADOT SDK instrumentiert und entweder zusammen mit dem Amazon CloudWatch Agent oder dem OpenTelemetry Collector ausgeführt werden.
Amazon EC2, Amazon ECS und Amazon EKS sind beispielsweise gängige Plattformen, auf denen AWS Application Signals Anleitungen zur Aktivierung des ADOT SDK und Amazon CloudWatch Agent bereitstellt.
## Wählen Sie Ihren adaptiven Sampling-Ansatz
Adaptives Sampling unterstützt zwei Ansätze: Sampling Boost und Anomaly Span Capture. Diese können unabhängig voneinander angewendet oder miteinander kombiniert werden.
### Steigerung der Probenahme
Adaptive Sampling Boost basiert auf Sampling-Regeln und funktioniert mit dem bestehenden Kopf-basierten Röntgen-Sampling-Modell. Bei der Stichprobenerhebung werden Entscheidungen über die Stichprobenerhebung beim Stammdienst getroffen und das Sampling-Flag anschließend an alle Dienste in der Aufrufkette weitergegeben.
+ **Regelbasiertes Boosten — Boosting** ist immer an eine bestimmte Röntgen-Sampling-Regel gebunden. Jede Regel kann ihre eigene maximale Boost-Rate und ihr eigenes Abkühlverhalten definieren.
+ **Kopf-basiertes Sampling** — Entscheidungen zur Probenahme werden beim Root-Service getroffen, und das Sampling-Flag wird nachgelagert an alle Services in der Aufrufkette weitergegeben.
+ **Anomaliegesteuert** — X-Ray verwendet das SDK, um Anomaliestatistiken zu melden. Wenn X-Ray Anomalien wie Fehler oder hohe Latenz erkennt, verwendet es diese Statistiken, um eine angemessene Boost-Rate (bis zum konfigurierten Maximum) zu berechnen.
**Meldung von Anomalien**
Jeder Anwendungsdienst in der Aufrufkette kann über das erforderliche SDK Anomaliestatistiken ausgeben:
+ **Root-Dienst** — Muss auf einem unterstützten SDK und einer unterstützten Plattform ausgeführt werden, um den Sampling-Boost zu aktivieren. Wenn der Root-Dienst nicht unterstützt wird, erfolgt kein Boost.
+ **Downstream-Dienste** — Downstream-Dienste melden nur Anomalien; sie können keine Stichprobenentscheidungen treffen. Wenn auf einem nachgelagerten Dienst ein unterstütztes SDK ausgeführt wird, können festgestellte Anomalien einen Anstieg der Probenahme auslösen. Wenn ein nachgelagerter Dienst nicht unterstützt wird (z. B. wenn ein älteres SDK ausgeführt wird), lösen Anomalien bei diesem Dienst keinen Boost aus. Diese Dienste können den Kontext immer noch flussabwärts weitergeben, wenn sie der Standardweiterleitung des Kontextes folgen (z. B. W3C-Trace-Kontext und Baggage). Dadurch wird sichergestellt, dass die SDKs in weiteren nachgelagerten Diensten unterstützten Dienste Anomalien melden können, die einen Boost auslösen.
**Erhöhen Sie den Zeitplan und den Umfang**
+ **Triggerverzögerung** — Sie können davon ausgehen, dass ein Sampling-Boost bereits 10 Sekunden nach der Erkennung einer Anomalie durch X-Ray einsetzt.
+ **Boost-Periode** — Nachdem X-Ray einen Boost ausgelöst hat, hält er bis zu 1 Minute an, bevor er wieder zur Basis-Samplingrate zurückkehrt.
+ **Boost-Abkühlung** — Nach einem Boost löst X-Ray keinen weiteren Boost für dieselbe Regel aus, bis das Abkühlfenster abgelaufen ist.
Wenn du zum Beispiel `cooldown` auf 10 Minuten festlegst und ein Boost endet, kann bis zum nächsten 10-Minuten-Fenster kein neuer Boost ausgelöst werden.
Sonderfall: Wenn du den Wert `cooldown` auf 1 Minute festlegst und ein Boost selbst bis zu 1 Minute andauern kann, können Boosts effektiv kontinuierlich ausgelöst werden, wenn die Anomalie weiterhin besteht.
**Anmerkung**
Verwenden Sie unterstützte Plattformen SDKs und Plattformen für Ihren Root-Service. Sampling Boost funktioniert nur mit unterstützten SDKs Plattformen. Sampling Boost hat zwar eine hohe Wahrscheinlichkeit, Spuren von Anomalien zu erfassen, es kann jedoch sein, dass nicht alle Spuren von Anomalien erfasst werden.
**Erhöhen Sie die Sichtbarkeit**
Wenn eine Sampling-Regel mit adaptivem Sampling-Boost konfiguriert ist, gibt X-Ray automatisch ausgelieferte Metriken aus, mit denen Sie die Boost-Aktivität überwachen können.
+ Name der **Metrik** — `SamplingRate`
+ **Dimension** — `RuleName` (auf den tatsächlichen Regelnamen gesetzt)
Jede Regel, für die diese `SamplingRateBoost` Option aktiviert ist, veröffentlicht ihre effektive Samplingrate, einschließlich der Basisrate und aller temporären Boosts. Das ermöglicht Ihnen Folgendes:
+ Verfolge, wann Boosts ausgelöst werden
+ Überwachen Sie die effektive Stichprobenrate für jede Regel
+ Korrelieren Sie Boosts mit Anwendungsanomalien (wie Fehlerspitzen oder Latenzereignissen)
Sie können diese Metriken in **Amazon CloudWatch Metrics unter dem Namespace AWS/X-Ray einsehen. Der Metrikwert ist eine Gleitkommazahl zwischen 0 und 1, die die effektive Stichprobenrate darstellt**.
**Konfigurieren Sie den Sampling-Boost mithilfe der Regeln für die X-Ray**
Sie können die adaptive Probenahme direkt in Ihren bestehenden Regeln für die Röntgenabtastung aktivieren, indem Sie ein neues `SamplingRateBoost` Feld hinzufügen. Weitere Informationen finden Sie unter [Sampling-Regeln anpassen](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-sampling.html#xray-console-custom). Dies bietet eine zentrale Möglichkeit, adaptives Sampling zu ermöglichen, ohne den Anwendungscode zu ändern oder die Anwendungsbereitstellung anzuwenden. Wenn Sie adaptives Sampling aktivieren, erhöht X-Ray automatisch die Abtastung bei Anomalien wie Fehlerspitzen oder Latenzausreißern und hält gleichzeitig die Abtastraten innerhalb des konfigurierten Maximums. `SamplingRateBoost`kann auf jede benutzerdefinierte Stichprobenregel mit Ausnahme der Stichprobenregel angewendet werden. `Default`
Das `SamplingRateBoost` Feld definiert die Obergrenze und das Verhalten bei anomaliebedingter Probenahme.
```
"SamplingRateBoost": {
"MaxRate": 0.25,
"CooldownWindowMinutes": 10
}
```
Der `MaxRate` definiert die maximale Abtastrate, mit der X-Ray Anomalien erkennt. Der Wertebereich ist `0.0` bis. `1.0` `"MaxRate": 0.25`Ermöglicht es beispielsweise, während eines Zeitfensters mit Anomalien die Anzahl der Anfragen anhand von Stichproben um bis zu 25% zu erhöhen. X-Ray bestimmt je nach Anomalieaktivität die angemessene Rate zwischen Ihrem Ausgangswert und dem Maximum.
Das `CooldownWindowMinutes` definiert ein Zeitfenster (in Minuten), in dem nur eine Erhöhung der Abtastrate ausgelöst werden kann. Nachdem ein Boost erfolgt ist, sind bis zum nächsten Fenster keine weiteren Boosts mehr zulässig. Der Wertetyp ist eine *Ganzzahl (Minuten)*.
**Beispielregel mit adaptiver Stichprobe**
```
{
"RuleName": "MyAdaptiveRule",
"Priority": 1,
"ReservoirSize": 1,
"FixedRate": 0.05,
"ServiceName": "*",
"ServiceType": "*",
"Host": "*",
"HTTPMethod": "*",
"URLPath": "*",
"SamplingRateBoost": {
"MaxRate": 0.25,
"CooldownWindowMinutes": 10
}
}
```
In diesem Beispiel beträgt die Ausgangsstichprobe 5% (`FixedRate: 0.05`). Bei Anomalien kann die Probenahme durch X-Ray um bis zu 25% erhöht werden ()`MaxRate: 0.25`. Boost nur einmal alle 10 Minuten.
**Konfiguration des Zustands von Anomalien**
Wenn keine Konfiguration für Anomaliebedingungen angegeben ist, verwendet das ADOT SDK **HTTP 5xx-Fehlercodes** als Standardbedingung für Anomalien, um den Sampling-Boost auszulösen.
Sie können Anomaliebedingungen auch lokal im unterstützten ADOT SDK mithilfe von Umgebungsvariablen fein abstimmen. Weitere Informationen finden Sie unter [Lokale SDK-Konfiguration](#local-sdk-configuration).
### Anomalie erstreckt sich über die Erfassung
Durch die Erfassung von Anomaliebereichen wird sichergestellt, dass kritische Bereiche, die Anomalien darstellen, immer aufgezeichnet werden, auch wenn nicht die gesamte Spur erfasst wird. Diese Funktion ergänzt die Steigerung der Probenahme, indem sie sich auf die Erfassung der Anomalie selbst konzentriert, anstatt die Probenahme für future Spuren zu erhöhen.
Wenn das ADOT SDK eine Anomalie erkennt, gibt es diese Spanne sofort aus, unabhängig von der Entscheidung für die Probenahme. Da das SDK nur Spans ausgibt, die sich auf die Anomalie beziehen, handelt es sich bei diesen Traces um Teil-Traces, nicht um vollständige Transaktionen. end-to-end
Sobald das ADOT SDK eine Spanne mit Anomalien erkennt, versucht es, so viele Spans wie möglich aus derselben Trace auszusenden. Alle im Rahmen dieser Funktion ausgegebenen Spans sind mit dem Attribut, gekennzeichnet. `aws.trace.flag.sampled = 0` Auf diese Weise können Sie bei der Transaktionssuche und -analyse auf einfache Weise partielle Spuren (Erfassung von Anomalien) von vollständigen Spuren (normale Probenahme) unterscheiden.
Wir empfehlen, [Transaction Search](https://docs.aws.amazon.com/xray/latest/devguide/xray-transactionsearch.html) zu integrieren, um partielle Traces anzeigen und abfragen zu können. Das folgende Beispiel zeigt eine Serviceseite in der [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html) Console. ServiceC ist mit der Erfassung von Anomalie-Spannen konfiguriert und ist Teil einer Anrufkette, bei der der Sampling-Boost angewendet wird. Diese Konfiguration generiert sowohl vollständige als auch teilweise Traces. Sie können das `aws.trace.flag.sampled` Attribut verwenden, um zwischen Trace-Typen zu unterscheiden.
![\[Anomalie erstreckt sich über die gesamte Erfassung\]](http://docs.aws.amazon.com/de_de/xray/latest/devguide/images/adaptive-sampling.png)
Die Erfassung von Anomaliespannen kann nur über den aktiviert oder angepasst werden. [Lokale SDK-Konfiguration](#local-sdk-configuration)
## Lokale SDK-Konfiguration
Sie können Funktionen für adaptives Sampling im ADOT SDK konfigurieren, indem Sie eine YAML-Konfiguration über eine Umgebungsvariable bereitstellen. Die lokale Konfiguration bietet eine detaillierte Kontrolle über Anomaliebedingungen und Schwellenwerte.
*Dies ist für die *Erfassung von Anomaliebereichen und optional für die Anpassung* der Bedingungen für den Probenahmeanstieg erforderlich.* Im Folgenden finden Sie ein Beispiel für die Konfiguration:
```
version: 1.0
anomalyConditions:
- errorCodeRegex: "^5\\d\\d$"
usage: both
- operations:
- "/api"
errorCodeRegex: "^429|5\\d\\d$"
highLatencyMs: 300
usage: sampling-boost
- highLatencyMs: 1000
usage: anomaly-span-capture
anomalyCaptureLimit:
anomalyTracesPerSecond: 1
```
Die Felddefinitionen sind unten aufgeführt:
+ `version`— Schemaversion für die Konfigurationsdatei
+ `anomalyConditions`— Definiert die Bedingungen, unter denen Anomalien erkannt werden, und wie sie verwendet werden
+ `errorCodeRegex`— Regulärer Ausdruck, der definiert, welche HTTP-Statuscodes als Anomalien betrachtet werden
+ `operations`— Liste der Operationen oder Endpunkte, für die die Bedingung gilt
+ `highLatencyMs`— Latenzschwellenwert (in Millisekunden), bei dessen Überschreitung Zeitspannen als Anomalien behandelt werden
+ `usage`— Definiert, für welches Feature die Bedingung gilt:
+ `both`— Gilt für **Sampling-Boost** und **Erfassung von Anomalie-Spannen** (Standardeinstellung, wenn keine Verwendung angegeben ist)
+ `sampling-boost`— Wird nur zum Auslösen von Sampling-Boosts verwendet
+ `anomaly-span-capture`— Wird nur für die Erfassung von Anomaliebereichen verwendet
+ `anomalyCaptureLimit`— Definiert Grenzwerte dafür, wie viele Spuren mit Anomaliespannen ausgegeben werden.
`anomalyTracesPerSecond`— Maximale Anzahl von Traces, die pro Sekunde erfasst werden, um eine übermäßige Spanne zu verhindern (der Standardwert ist 1, falls nicht anomalyCaptureLimit vorhanden).
**Anmerkung**
`AnomalyConditions`**überschreibt** die standardmäßige Anomaliebedingung für Sampling-Boost (HTTP 5xx). Wenn Sie die Standardbedingung beibehalten möchten, während Sie die lokale Konfiguration verwenden, müssen Sie sie explizit in jedes Element von aufnehmen. `AnomalyConditions`
Für jedes `anomalyConditions` Element:
Wenn das `operations` Feld **weggelassen** wird, gilt die Bedingung für **alle Operationen** (Service Level)
Wenn das `operations` Feld zwar vorhanden, aber auf eine **leere Liste** gesetzt ist, gilt die Bedingung für „**Keine Operationen**“, sodass dieses Element nicht aktiviert ist
Wenn `errorCodeRegex` sowohl als auch weggelassen `highLatencyMs` werden, gibt es für die Bedingung keine zu bewertenden Anomaliekriterien, sodass dieses Element nicht berücksichtigt werden kann
Logische Beziehungen:
Zwischen den Elementen in `anomalyConditions` der Datei ist die Beziehung **ODER**.
Innerhalb eines einzelnen Elements werden mehrere Felder (z. B. `errorCodeRegex` und`highLatencyMs`) mit **UND** kombiniert.
Zum Beispiel:
```
errorCodeRegex: "^429|5\\d\\d$"
highLatencyMs: 300
```
Diese Bedingung bedeutet, dass der **Statuscode 429 oder 5xx UND einer Latenz von ≥ 300 ms entspricht**.
### Wenden Sie die lokale Konfiguration auf das ADOT SDK an
Sie können die lokale Konfiguration auf das ADOT SDK anwenden, indem Sie die Umgebungsvariable festlegen. `AWS_XRAY_ADAPTIVE_SAMPLING_CONFIG` Der Wert muss ein gültiges YAML-Dokument sein (inline oder verschachtelt).
Beispielsweise legen Amazon EC2 und Amazon ECS die Umgebungsvariable direkt fest:
```
AWS_XRAY_ADAPTIVE_SAMPLING_CONFIG="{version: 1.0, anomalyConditions: [{errorCodeRegex: \"^500$\", usage: \"sampling-boost\"}, {errorCodeRegex: \"^501$\", usage: \"anomaly-trace-capture\"}], anomalyCaptureLimit: {anomalyTracesPerSecond: 10}}"
```
Definieren Sie für Amazon EKS die Umgebungsvariable in der Pod-Spezifikation als verschachteltes YAML:
```
apiVersion: v1
kind: Pod
metadata:
name: adot-sample
spec:
containers:
- name: adot-app
image: my-app:latest
env:
- name: AWS_XRAY_ADAPTIVE_SAMPLING_CONFIG
value: |
version: 1.0
anomalyConditions:
- errorCodeRegex: "^500$"
usage: sampling-boost
- errorCodeRegex: "^501$"
usage: anomaly-trace-capture
anomalyCaptureLimit:
anomalyTracesPerSecond: 10
```
# Deep Linking für Konsolen
Sie können Routen und Abfragen verwenden, um Deeplinks zu bestimmten Traces oder gefilterten Ansichten von Traces und der Trace-Map zu erstellen.
**Konsolenseiten**
+ Willkommensseite — [xray/home\$1/welcome](https://console.aws.amazon.com/xray/home#/welcome)
+ Erste Schritte — [xray/home\$1/getting-gestartet](https://console.aws.amazon.com/xray/home#/getting-started)
+ [Trace-Map — xray/home\$1/service -map](https://console.aws.amazon.com/xray/home#/service-map)
+ Spuren — [xray/home\$1/traces](https://console.aws.amazon.com/xray/home#/traces)
## Ablaufverfolgungen
Sie können Links für Timeline-, Roh- und Kartenansichten einzelner Ablaufverfolgungen generieren.
**Zeitleiste verfolgen** — `xray/home#/traces/trace-id`
**Unverarbeitete Trace-Daten** — `xray/home#/traces/trace-id/raw`
**Example — rohe Trace-Daten**
```
https://console.aws.amazon.com/xray/home#/traces/1-57f5498f-d91047849216d0f2ea3b6442/raw
```
## Filterausdrücke
Link zu einer gefilterten Liste von Ablaufverfolgungsdaten.
**Ansicht gefilterter Spuren** — `xray/home#/traces?filter=filter-expression`
**Example — Ausdruck filtern**
```
https://console.aws.amazon.com/xray/home#/traces?filter=service("api.amazon.com") { fault = true OR responsetime > 2.5 } AND annotation.foo = "bar"
```
**Example — Filterausdruck (URL-kodiert)**
```
https://console.aws.amazon.com/xray/home#/traces?filter=service(%22api.amazon.com%22)%20%7B%20fault%20%3D%20true%20OR%20responsetime%20%3E%202.5%20%7D%20AND%20annotation.foo%20%3D%20%22bar%22
```
Weitere Informationen zu Filterausdrücken finden Sie unter [Verwenden von Filterausdrücken](xray-console-filters.md).
## Zeitraum
Geben Sie eine Zeitdauer oder Start- und Endzeit im Format ISO86 01 an. Zeitbereiche sind in UTC angegeben und können bis zu 6 Stunden lang sein.
**Länge der Zeit** — `xray/home#/page?timeRange=range-in-minutes`
**Example — Trace-Map für die letzte Stunde**
```
https://console.aws.amazon.com/xray/home#/service-map?timeRange=PT1H
```
**Start- und Endzeit** — `xray/home#/page?timeRange=start~end`
**Example — Sekundengenauer Zeitbereich**
```
https://console.aws.amazon.com/xray/home#/traces?timeRange=2023-7-01T16:00:00~2023-7-01T22:00:00
```
**Example — minutengenauer Zeitbereich**
```
https://console.aws.amazon.com/xray/home#/traces?timeRange=2023-7-01T16:00~2023-7-01T22:00
```
## Region
Geben Sie AWS-Region an, ob auf Seiten in dieser Region verlinkt werden soll. Wenn Sie keine Region angeben, führt Sie die Konsole zur zuletzt besuchten Region.
**Region** — `xray/home?region=region#/page`
**Example — Streckenkarte in den USA West (Oregon) (us-west-2)**
```
https://console.aws.amazon.com/xray/home?region=us-west-2#/service-map
```
Wenn Sie eine Region mit anderen Abfrageparametern angeben, steht die Regionsabfrage vor dem Hash und die X-Ray-specific Abfragen hinter dem Seitennamen.
**Example — Streckenkarte für die letzte Stunde in US West (Oregon) (us-west-2)**
```
https://console.aws.amazon.com/xray/home?region=us-west-2#/service-map?timeRange=PT1H
```
## Kombiniert
**Example — aktuelle Spuren mit einem Dauerfilter**
```
https://console.aws.amazon.com/xray/home#/traces?timeRange=PT15M&filter=duration%20%3E%3D%205%20AND%20duration%20%3C%3D%208
```
**Output**
+ Seite — Spuren
+ Zeitraum — Letzte 15 Minuten
+ Filter — Dauer >= 5 UND Dauer <= 8