AWS X-Ray-Konsole - AWS X-Ray

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AWS X-Ray-Konsole

DieAWS X-RayMit der Konsole können Sie eine Service-Übersicht und die zugehörigen Ablaufverfolgungen für Anforderungen anzeigen, die von Ihren Anwendungen verarbeitet werden.

Die Service-Übersicht der Konsole ist eine visuelle Darstellung der JSON-Service-Grafik, die X-Ray aus den Ablaufverfolgungsdaten Ihrer Anwendungen 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.

Mithilfe von Filtern können Sie eine Service-Übersicht oder Ablaufverfolgungen für eine bestimmte Anforderung, einen Service, eine Verbindung zwischen zwei Services (eine Edge) oder Anforderungen anzeigen, die eine Bedingung erfüllen. X-Ray stellt Filterausdrücke zum Filtern von Anforderungen, Services und Edges basierend auf den Daten in Anforderungs-Headern, im Antwortstatus und in indizierten Feldern der ursprünglichen Segmente bereit.

Anmerkung

Die X-Ray-Service-Übersicht kann bis zu 10.000 Knoten anzeigen. In seltenen Szenarien, in denen die Gesamtzahl der Serviceknoten dieses Limit überschreitet, erhalten Sie möglicherweise einen Fehler und können keine vollständige Service-Map in der Konsole anzeigen.

Anzeigen der Service-Übersicht

Zeigen Sie die Service-Übersicht in der X-Ray-Konsole an, um fehlerhafte Services, Verbindungen mit hoher Latenz oder Ablaufverfolgungen für erfolglose Anforderungen zu identifizieren.

Zeigen Sie die Service-Übersicht wie folgt an:

  1. Öffnen SieX-Ray Konsoleaus. Standardmäßig wird die Service-Übersicht angezeigt. Sie können auch „auswählen“Service-Übersichtaus dem linken Navigationsbereich.

    Anmerkung

    Sie können jetzt die Service-Übersicht innerhalb von Amazon anzeigen. CloudWatch console. Öffnen SieCloudWatch-Konsoleund wähleService-ÜbersichtunterX-Ray-aus dem linken Navigationsbereich. Sie können auch weiterhin die X-Ray-Konsole verwenden.

    
            Kartenseite für die X-Ray-Konsole
  2. 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.

  3. Verwenden Sie das Histogramm, um Ablaufverfolgungen nach Dauer zu filtern, und wählen Sie die Statuscodes aus, deren Ablaufverfolgungen Sie anzeigen möchten. Klicken Sie anschließend auf View traces, um die Ablaufverfolgungsliste mit angewendetem Filterausdruck zu öffnen.

    Innerhalb derCloudWatch-Konsole, wählen Sie einen Serviceknoten in der X-Ray Service-Map aus, um zusätzliche Informationen anzuzeigen, einschließlich Registerkarten für Metriken, Warnungen und Reaktionszeitverteilung. Auf derMetriken, wählen Sie einen Bereich in jedem Diagramm aus, um weitere Details anzuzeigen, oder wählen SieStörungenoderFehlerOptionen zum Filtern von Traces. Auf derReaktionszeitverteilungwählen Sie einen Bereich innerhalb des Diagramms aus, um Traces nach Reaktionszeit zu filtern. Sie können Ablaufverfolgungen jederzeit anzeigen, indem SieTraces anzeigenoder wenn ein Filter angewendet wurde, wählen SieZeigen Sie gefilterteaus.

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”)

In der Mitte jedes Knotens zeigt die Konsole die durchschnittliche Reaktionszeit und die Anzahl der während des ausgewählten Zeitraums pro Minute gesendeten Ablaufverfolgungen an.

Ist die Service-Übersicht groß, zeigt die Konsole standardmäßig eine verkleinerte Ansicht an. Verwenden Sie die Steuerelemente auf dem Bildschirm oder die Maus, um das Bild zu vergrößern, zu verkleinern oder zu verschieben.

Kontrollen

  • — Vergrößern oderausaus. Sie können auch mit dem Mausrad vergrößern oder verkleinern.

  • — Scrollen in der Service-Übersicht. Klicken und ziehen Sie, um mit der Maus zu scrollen.

  • — Rahmen des ausgewählten Knotens oder der ausgewählten Kante in der Mitte der Übersicht ein.

Anzeigen der Service-Übersicht nach Gruppe

Mit einem Filterausdruck können Sie Kriterien definieren, nach denen Ablaufverfolgungen in einer Gruppe akzeptiert werden sollen. Führen Sie die folgenden Schritte aus, um dann diese spezielle Gruppe in der Service-Übersicht anzuzeigen.

So zeigen Sie eine Service-Übersicht der Gruppe an

  1. Öffnen SieSeite für die Service-Übersichtder X-Ray-Konsole.

  2. Wählen Sie einen Gruppennamen aus dem Dropdown-Menü links neben der Suchleiste aus.

Ändern der Knoten-Darstellung

Verwenden Sie die folgenden Optionen, um die Darstellung der Service-Übersicht zu ändern. Sie können Dienstsymbole aktivieren, um den Fluss der Dienste besser verfolgen zu können, und Sie können die Gewichtung Ihrer Knoten ändern, um den Datenverkehr oder Zustand besser darzustellen.

So ändern Sie die Knotenpräsentation

  1. Öffnen SieSeite für die Service-Übersichtder X-Ray-Konsole oder einer einzelnen Ablaufverfolgungs-Übersicht.

    Knotenoptionen befinden sich unten rechts auf der Karte.

  2. Wählen Sie eine Darstellung für Ihren Knoten aus.

    Service Icons enabled

    Service-Symbole — Wenn diese Option aktiviert ist, wird ein Symbol für dieAWSService, der durch den Knoten angezeigt wird, statt der Standardübersicht der Aktivität.

    Node weight by None

    Keine— Alle Knoten haben dieselbe Gewichtung.

    Node weight by Health

    Integrität— Die Knotengröße wird durch die Gesamtzahl der betroffenen Anforderungen berechnet. Zu den betroffenen Anforderungen gehören fault, error und throttle. Beispielsweise hat ein Knoten mit 10 % aller betroffenen Anforderungen von 1000 Stichproben (100 Anfragen betroffen) eine größere Knotengröße als ein Knoten mit nur 50 % aller betroffenen Anforderungen von 100 Stichproben (50 Anfragen betroffen).

    Node weight by Traffic

    Datenverkehr— Die Knotengröße wird durch die Gesamtzahl der Stichprobenanforderungen berechnet. Beispielsweise hat ein Knoten mit 1000 Stichprobenanforderungen eine größere Knotengröße als einer mit 100 Stichprobenanforderungen.

Anzeigen von Ablaufverfolgungen

Verwenden Sie die Ablaufverfolgungsliste in der X-Ray -Konsole, um mithilfe der URL, des Codes oder anderer Daten aus der Ablaufverfolgungsübersicht nach Ablaufverfolgungen zu suchen.

X-Ray console

So zeigen Sie Traces in der X-Ray-Konsole

  1. Öffnen SieTrace-Übersichtin der X-Ray-Konsole.

    
                  Ablaufverfolgungsliste in der X-Ray -Konsole, um Ablaufverfolgungen nach URL, Antwortcode oder anderen Daten aus der Ablaufverfolgungsübersicht zu suchen
  2. Wählen Sie eine URL aus, um die Ablaufverfolgungsliste zu filtern.

  3. Wählen Sie eine Ablaufverfolgungs-ID aus, um die Ablaufverfolgungskarte und die Timeline für eine Ablaufverfolgung anzuzeigen

    
                  Trace-ID auswählen, um die Ablaufverfolgungskarte und die Timeline für eine Ablaufverfolgung anzuzeigen.
CloudWatch console

So zeigen Sie Spuren im CloudWatch Konsole

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

  2. Klicken Sie aufAblaufverfolgungenunterX-Ray-im linken Navigationsbereich. DieAblaufverfolgungenSeite ermöglicht es Ihnen, nach Gruppe zu filtern und optional eineFilterausdruckum die Traces zu filtern, die imAblaufverfolgungen-Abschnitt unten auf der Seite.

  3. Verfeinern Sie Ihre Anfrage imAbfragen von RaffinernAbschnitts erstellt. Sie können eine Option aus derAbfrage verfeinern um, um nach Knoten, URL und zusätzlichen Filtern zu filtern. Eine Liste der verfügbaren Filterwerte wird unmittelbar unten angezeigt. Wählen Sie mindestens einen Eintrag aus und wählen SieZur Abfrage hinzufügenzum Filterausdruck oben auf der Seite hinzuzufügen.

    
                  Filterverfolgungen
  4. Klicken Sie aufAbfrage ausführenjederzeit, um eine Liste mit übereinstimmenden Traces innerhalb derAblaufverfolgungen-Abschnitt unten auf der Seite.

  5. Wählen Sie eine Trace-ID aus der Liste aus, um dieTrace-DetailsSeite für einen einzelnen Trace. EINTrace-Übersichtwird angezeigt, die die am Trace beteiligten Knoten sowie eine Trace-Zusammenfassung und eine Zeitleiste von Trace-Segmenten anzeigen.

    
                  Trace-ID auswählen, um die Ablaufverfolgungskarte und die Timeline für eine Ablaufverfolgung anzuzeigen.

Die Timeline-Ansicht zeigt eine Hierarchie der Segmente und Untersegmente. Der erste Eintrag in der Liste ist das Segment, das alle vom Service für eine einzelne Anforderung aufgezeichneten Daten darstellt.


        Timeline-Ansicht mit Segment- und Untersegmenthierarchie mit Segment als erstem Eintrag in der Liste

Unter dem Segment befinden sich Untersegmente. In diesem Beispiel werden die von instrumentierten Amazon DynamoDB DynamoDB-Clients aufgezeichneten Untersegmente sowie ein angepasstes Untersegment gezeigt.


        Timeline-Ansicht von Untersegmenten, aufgezeichnet nach instrumentierten Amazon DynamoDB DynamoDB-Clients, und ein angepasstes Untersegment

Das X-Ray SDK zeichnet Untersegmente automatisch auf, wenn Sie ein instrumentiertesAWSSDK-, HTTP- oder SQL-Client für das Ausführen von Aufrufen bei externen Ressourcen. Sie können das SDK auch anweisen, benutzerdefinierte Untersegmente für alle Funktionen oder Codeblöcke aufzuzeichnen. Zusätzliche Untersegmente, die bei einem geöffneten benutzerdefinierten Untersegment aufgezeichnet wurden, werden zu untergeordneten Elementen von benutzerdefinierten Untersegmenten.

Von der Timeline-Ansicht aus können Sie auch auf die Ablaufverfolgungsrohdaten zugreifen, die von der Konsole zum Erstellen der Timeline verwendet werden. Wählen Sie Raw data aus, um das JSON-Dokument anzuzeigen, das alle Segmente und Untersegmente enthält, aus denen die Ablaufverfolgung besteht.


        JSON-Rohdatendokument mit allen Segmenten und Untersegmenten, aus denen die Ablaufverfolgung besteht

Anzeigen von Segmentdetails

Wählen Sie anhand der Ablaufverfolgungs-Timeline den Namen eines im Detail anzuzeigenden Segments aus. Die Registerkarte Overview (Übersicht) zeigt Informationen zu Anforderung und Antwort an.


        Segmentübersicht in Ablaufverfolgungs-Timeline mit Informationen zu Anforderung und Antwort

DieRessourcendie Registerkarte für ein Segment zeigt Informationen zumAWSRessourcen, auf denen Ihre Anwendung und das X-Ray-SDK ausgeführt wird. Verwenden Sie das Amazon EC2,AWS Elastic Beanstalkoder Amazon ECS-Plugin für das SDK zum Aufzeichnen von Service-spezifischen Ressourceninformationen.


        Registerkarte Resources (Ressourcen) für ein Segment mit Informationen zumAWSRessourcen, die Ihre Anwendung und das X-Ray-SDK ausführen

Die restlichen Registerkarten zeigen Annotations, Metadaten und Exceptions an, die auf dem Segment aufgezeichnet wurden. Ausnahmen werden automatisch erfasst, wenn sie von einer instrumentierten Anforderung ausgelöst werden. Anmerkungen und Metadaten enthalten zusätzliche Informationen, die Sie mithilfe der im SDK bereitgestellten Methoden aufzeichnen können.


        Registerkarte "Annotations (Anmerkungen)" mit zusätzlichen Informationen zum Segment

Anzeigen von Untersegmentdetails

Wählen Sie anhand der Ablaufverfolgungs-Timeline den Namen eines im Detail anzuzeigenden Segments aus. Für die mit instrumentierten Clients generierten Untersegmente enthält die Registerkarte Overview (Übersicht) Informationen zu Anforderung und Antwort aus der Sicht Ihrer Anwendung. In diesem Beispiel wird ein Untersegment von einem instrumentierten Aufruf von DynamoDB gezeigt.


        Informationen zu Untersegmenten aus einem instrumentierten Aufruf an DynamoDB

DieRessourcenDie Registerkarte für ein Untersegment zeigt Details zur DynamoDB-Tabelle, zum aufgerufenen Vorgang und zur Anforderungs-ID an.


        Die Beschreibung der Ressourcen für dieses Untersegment zeigt Details zurDynamoDB -Tabelle, zum aufgerufenen Vorgang und zur Anforderungs-ID.

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.


        Übersichtsinformationen für ein benutzerdefiniertes Untersegment

Mit benutzerdefinierten Untersegmenten können Sie Untersegmente von instrumentierten Clients in Gruppen organisieren. Außerdem können Sie Metadaten und Anmerkungen für Untersegmente aufzeichnen. Dies kann beim Debuggen von Funktionen hilfreich sein.


        Zeichnen Sie Metadaten für benutzerdefinierte Untersegmente auf, um Ihnen zu helfen, Funktionen zu debuggen.

In diesem Beispiel zeichnet die Anwendung den Status jedesGame-Objekt, das es in DynamoDB speichert. Dies geschieht, indem sie das Objekt an die putMetadata-Methode auf dem Untersegment übergibt. Das X-Ray-SDK serialisiert das Objekt in JSON und fügt es dem Segmentdokument hinzu.