Konfigurieren des AWS X-Ray-Debuggings

Sie können die AWS Elastic Beanstalk-Konsole oder eine Konfigurationsdatei für die Ausführung des AWS X-Ray-Daemon auf den Instances in Ihrer Umgebung verwenden. X-Ray ist ein AWS-Service, der Daten über die Anforderungen erfasst, die Ihre Anwendung verwendet, um eine Servicezuordnung zu erstellen, die Sie verwenden können, um Probleme mit Ihrer Anwendung und Möglichkeiten zur Optimierung zu identifizieren.

Anmerkung

X-Ray wird nicht in allen Regionen angeboten. Wenn Sie eine Umgebung in einer dieser Regionen erstellen, können Sie den X-Ray-Daemon auf den Instances in Ihrer Umgebung nicht ausführen.

Weitere Informationen zu den AWSServices, die in den einzelnen Regionen angeboten werden, finden Sie in der Tabelle der Regionen.

X-Ray bietet ein SDK, das Sie verwenden können, um Ihren Anwendungscode zu instrumentalisieren, sowie eine Daemon-Anwendung, die Debugging-Informationen vom SDK an die X-Ray-API weiterleitet.

Unterstützte Plattformen

Sie können das X-Ray SDK mit den folgenden Elastic Beanstalk-Plattformen verwenden:

• Go – Version 2.9.1 und höher

• Java 8 – Version 2.3.0 und höher

• Java 8 mit Tomcat 8 – Version 2.4.0 und höher

• Node.js – Version 3.2.0 und höher

• Windows Server – alle Plattformversionen, die am oder nach dem 18. Dezember 2016 veröffentlicht wurden

• Python - Version 2.5.0 und höher

Auf unterstützten Plattformen können Sie eine Konfigurationsoption für die Ausführung des X-Ray-Daemon auf den Instances in Ihrer Umgebung verwenden. Sie können den Daemon in der Elastic Beanstalk-Konsole oder über eine Konfigurationsdatei aktivieren.

Der X-Ray-Daemon benötigt IAM-Berechtigungen in der verwalteten Richtlinie AWSXrayWriteOnlyAccess, um Daten in X-Ray hochzuladen. Diese Berechtigungen sind im Elastic Beanstalk-Instance-Profil enthalten. Wenn Sie nicht das Standard-Instance-Profil verwenden, finden Sie Informationen unter Erteilen der Berechtigung zum Senden von Daten an X-Ray für den Daemon im AWS X-Ray-Entwicklerhandbuch.

Debugging mit X-Ray erfordert die Verwendung des X-Ray-SDK. Anweisungen und Beispielanwendungen finden Sie unter Erste Schritte mit AWS X-Ray im AWS X-Ray-Benutzerhandbuch.

Wenn Sie eine Plattformversion verwenden, die nicht über den Daemon verfügt, können Sie sie trotzdem mit einem Skript in einer Konfigurationsdatei ausführen. Weitere Informationen finden Sie unter Manuelles Herunterladen und Ausführen des X-Ray-Daemons (Erweitert) im AWS X-Ray-Entwicklerhandbuch.

Konfigurieren des Debuggings

Sie können den X-Ray-Daemon auf einer laufenden Umgebung in der Elastic Beanstalk-Konsole aktivieren.

So aktivieren Sie das Debugging in der Elastic Beanstalk-Konsole

1. Öffnen Sie die Elastic-Beanstalk-Konsole und wählen Sie in der Liste Regions (Regionen) Ihre AWS-Region aus.

2. Wählen Sie im Navigationsbereich Environments (Umgebungen) aus und wählen Sie dann in der Liste den Namen Ihrer Umgebung aus.

   Anmerkung

   Wenn Sie viele Umgebungen haben, verwenden Sie die Suchleiste, um die Umgebungsliste zu filtern.

3. Wählen Sie im Navigationsbereich Configuration (Konfiguration) aus.

4. Wählen Sie in der Konfigurationskategorie Updates, monitoring and logging  (Updates, Überwachung und Protokolle) die Option Edit (Bearbeiten) aus.

5. Wählen Sie im Abschnitt Amazon X-Ray die Option Aktiviert aus.

6. Wählen Sie unten auf der Seite die Option Apply (Anwenden) aus, um die Änderungen zu speichern.

Sie können diese Option auch während der Umgebungserstellung aktivieren. Weitere Informationen finden Sie unter Der Assistent zum Erstellen einer neuen Umgebung.

Der Namespace aws:elasticbeanstalk:xray

Sie können mit der XRayEnabled-Option im aws:elasticbeanstalk:xray-Namespace Debugging aktivieren.

Um das Debugging bei der Bereitstellung Ihrer Anwendung automatisch zu aktivieren, legen Sie die Option in einer Konfigurationsdatei in Ihrem Quellcode wie folgt fest.

Beispiel .ebextensions/debugging.config

option_settings:
  aws:elasticbeanstalk:xray:
    XRayEnabled: true