View a markdown version of this page

AWS X-Ray Beispielapplikation - 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 Beispielapplikation

Anmerkung

X-Ray SDK/Daemon Wartungshinweis — Am 25. Februar 2026 wechselt das in den AWS X-Ray SDKs/Daemon Wartungsmodus, in dem die X-Ray SDK- und Daemon-Versionen begrenzt AWS werden, um ausschließlich Sicherheitsprobleme zu beheben. Weitere Informationen zum Zeitplan für den Support finden Sie unter. Zeitplan für die Support von X-Ray SDK und Daemon Wir empfehlen die Migration zu OpenTelemetry. Weitere Informationen zur Migration zu OpenTelemetry finden Sie unter Migration von X-Ray Instrumentierung zu OpenTelemetry Instrumentierung.

Die Beispiel-App AWS X-Ray eb-java-scorekeep, die unter verfügbar ist, zeigt die Verwendung des AWS X-Ray SDK zur Instrumentierung eingehender HTTP-Aufrufe GitHub, DynamoDB-SDK-Clients und HTTP-Clients. Die Beispiel-App wird verwendet CloudFormation , um DynamoDB-Tabellen zu erstellen, Java-Code auf einer Instanz zu kompilieren und den Daemon ohne zusätzliche Konfiguration auszuführen. X-Ray

Sehen Sie sich das Scorekeep-Tutorial an, um mit der Installation und Verwendung einer instrumentierten Beispielanwendung zu beginnen. Verwenden Sie dazu die oder. AWS-Managementkonsole AWS CLI

Scorekeep verwendet das AWS X-Ray SDK, um eingehende HTTP-Aufrufe, DynamoDB-SDK-Clients und HTTP-Clients zu instrumentieren

Das Beispiel umfasst eine Front-End-Web-App, die von ihr aufgerufene API und die DynamoDB-Tabellen, die zum Speichern von Daten verwendet werden. Die grundlegende Instrumentierung mit Filtern , Plugins und instrumentierten AWS SDK-Clients wird im Zweig des Projekts gezeigt. xray-gettingstarted Dies ist die Verzweigung, die Sie im Tutorial "Erste Schritte" bereitstellen. Da diese Verzweigung nur die Grundlagen beinhaltet, können Sie einen diff-Vorgang mit der master-Verzweigung durchführen, um schnell die Grundlagen zu erfassen.

Die Servicekarte zeigt, wie der Client eine Verbindung zum Scorekeep-Container herstellt, der eine Verbindung zu DynamoDB Tabellen und SNS herstellt.

Die Beispielanwendung veranschaulicht die grundlegende Instrumentierung in folgenden Dateien:

Der xray Zweig der Anwendung umfasst die Verwendung von HttpClient, Anmerkungen, SQL-Abfragen, benutzerdefinierten Untersegmenten , einer instrumentierten AWS Lambda Funktion sowie instrumentiertem Initialisierungscode und Skripten.

Um die Benutzeranmeldung und AWS SDK für JavaScript Nutzung im Browser zu unterstützen, fügt der xray-cognito Zweig Amazon Cognito hinzu, um die Benutzerauthentifizierung und -autorisierung zu unterstützen. Mit den von Amazon Cognito abgerufenen Anmeldeinformationen sendet die Web-App auch Trace-Daten X-Ray , um Anforderungsinformationen aus Kundensicht aufzuzeichnen. Der Browser-Client erscheint als eigener Knoten auf der Trace-Map und zeichnet zusätzliche Informationen auf, darunter die URL der Seite, die der Benutzer gerade betrachtet, und die ID des Benutzers.

Schließlich fügt der xray-worker Branch eine instrumentierte Python-Lambda-Funktion hinzu, die unabhängig ausgeführt wird und Elemente aus einer Amazon SQS-Warteschlange verarbeitet. Scorekeep fügt ein Element zur Warteschlange hinzu, wenn ein Spiel endet. Der durch CloudWatch Ereignisse ausgelöste Lambda-Worker ruft alle paar Minuten Elemente aus der Warteschlange ab und verarbeitet sie, um Spielaufzeichnungen zur Analyse in Amazon S3 zu speichern.

Topics