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.
Anmerkung
Sie können den CloudWatch Agenten jetzt verwenden, um Metriken, Protokolle und Traces von EC2 Amazon-Instances und lokalen Servern zu sammeln. CloudWatch Agentenversion 1.300025.0 und höher können Traces von OpenTelemetryunserem X-Ray-Client SDKs sammeln und an X-Ray senden. Wenn Sie den CloudWatch Agenten anstelle des AWS Distro for OpenTelemetry (ADOT) Collector oder des X-Ray-Daemons zum Sammeln von Traces verwenden, können Sie die Anzahl der verwalteten Agenten reduzieren. Weitere Informationen finden Sie unter dem Thema CloudWatch Agent im CloudWatch Benutzerhandbuch.
Der AWS X-Ray Daemon ist eine Softwareanwendung, die den Datenverkehr auf dem UDP-Port 2000 überwacht, Rohsegmentdaten sammelt und sie an die API weiterleitet. AWS X-Ray Der Daemon arbeitet mit dem zusammen AWS X-Ray SDKs und muss laufen, damit die vom gesendeten Daten den X-Ray-Dienst erreichen SDKs können. Der X-Ray-Daemon ist ein Open-Source-Projekt. Du kannst dem Projekt folgen und Issues und Pull-Requests einreichen auf GitHub: github. com/aws/aws-Xray-Daemon
Aktivieren AWS Lambda und AWS Elastic Beanstalk verwenden Sie die Integration dieser Dienste mit X-Ray, um den Daemon auszuführen. Lambda führt den Daemon jedes Mal automatisch aus, wenn eine Funktion für eine Stichprobenanforderung aufgerufen wird. Verwenden Sie auf Elastic Beanstalk die XRayEnabled Konfigurationsoption, um den Daemon auf den Instances in Ihrer Umgebung auszuführen. Weitere Informationen finden Sie unter
Um den X-Ray-Daemon lokal, lokal oder auf einem anderen Server auszuführen, laden Sie ihn herunter AWS-Services, führen Sie ihn aus und geben Sie ihm dann die Erlaubnis, Segmentdokumente auf X-Ray hochzuladen.
Herunterladen des Daemons
Sie können den Daemon von Amazon S3, Amazon ECR oder Docker Hub herunterladen und ihn dann lokal ausführen oder ihn beim Start auf einer EC2 Amazon-Instance installieren.
X-Ray-Daemon-Installationsprogramme und ausführbare Dateien
-
Linux (RPM-Installationsprogramm) —
aws-xray-daemon-3.x.rpm
-
Linux (DEB-Installationsprogramm) —
aws-xray-daemon-3.x.deb
-
Linux (ARM64, ausführbar) —
aws-xray-daemon-linux-arm64-3.x.zip
(sig ) -
Linux (ARM64, RPM-Installationsprogramm) —
aws-xray-daemon-arm64-3.x.rpm
-
Linux (ARM64, DEB-Installationsprogramm) —
aws-xray-daemon-arm64-3.x.deb
-
OS X (ausführbar) —
aws-xray-daemon-macos-3.x.zip
(sig ) -
Windows (ausführbar) —
aws-xray-daemon-windows-process-3.x.zip
(sig ) -
Windows (Dienst) —
aws-xray-daemon-windows-service-3.x.zip
(sig )
Diese Links verweisen immer auf die neueste 3.x-Version des Daemons. Gehen Sie wie folgt vor, um eine bestimmte Version herunterzuladen:
-
Wenn Sie eine frühere Version herunterladen möchten
3.3.0
,3.x
ersetzen Sie sie durch die Versionsnummer. Beispiel,2.1.0
. Vor der Version3.3.0
ist die einzig verfügbare Architekturarm64
. Beispiel:2.1.0
undarm64
. -
Wenn Sie eine Version nach der anderen herunterladen möchten
3.3.0
,3.x
ersetzen Sie diese durch die Versionsnummer undarch
den Architekturtyp.
X-Ray-Assets werden in jeder unterstützten Region in Buckets repliziert. Um den Bucket zu verwenden, der Ihnen oder Ihren AWS Ressourcen am nächsten ist, ersetzen Sie die Region in den obigen Links durch Ihre Region.
https://s3.us-west-2
.amazonaws.com/aws-xray-assets.us-west-2
/xray-daemon/aws-xray-daemon-3.x.rpm
Überprüfen der Signatur des Daemon-Archivs
GPG-Signatur-Dateien sind für Daemon-Komponenten in komprimierten ZIP-Archiven eingeschlossen. Der öffentliche Schlüssel befindet sich hier: aws-xray.gpg
Sie können den öffentlichen Schlüssel verwenden, um zu überprüfen, ob das Daemon-ZIP-Archiv ein Original und unverändert ist. Importieren Sie zunächst den öffentlichen Schlüssel mit GnuPG
So importieren Sie den öffentlichen Schlüssel
-
Laden Sie den öffentlichen Schlüssel herunter.
$
BUCKETURL=https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2
$wget $BUCKETURL/xray-daemon/aws-xray.gpg
-
Importieren Sie den öffentlichen Schlüssel in Ihren Schlüsselbund.
$
gpg --import aws-xray.gpg
gpg: /Users/me/.gnupg/trustdb.gpg: trustdb created gpg: key 7BFE036BFE6157D3: public key "AWS X-Ray <aws-xray@amazon.com>" imported gpg: Total number processed: 1 gpg: imported: 1
Verwenden Sie den importierten Schlüssel, um die Signatur des Daemon-ZIP-Archivs zu überprüfen.
So überprüfen Sie die Signatur eines Archivs
-
Laden Sie das Archiv und die Signaturdatei herunter.
$
BUCKETURL=https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2
$wget $BUCKETURL/xray-daemon/aws-xray-daemon-linux-3.x.zip
$wget $BUCKETURL/xray-daemon/aws-xray-daemon-linux-3.x.zip.sig
-
Führen Sie
gpg --verify
aus, um die Signatur zu überprüfen.$
gpg --verify aws-xray-daemon-linux-3.x.zip.sig aws-xray-daemon-linux-3.x.zip
gpg: Signature made Wed 19 Apr 2017 05:06:31 AM UTC using RSA key ID FE6157D3 gpg: Good signature from "AWS X-Ray <aws-xray@amazon.com>" gpg: WARNING: This key is not certified with a trusted signature! gpg: There is no indication that the signature belongs to the owner. Primary key fingerprint: EA6D 9271 FBF3 6990 277F 4B87 7BFE 036B FE61 57D3
Beachten Sie die Warnung zu vertrauenswürdigen Inhalten. Ein Schlüssel ist nur vertrauenswürdig, wenn Sie oder eine Person Ihres Vertrauens ihn signiert hat. Das bedeutet nicht, dass die Signatur ungültig ist, sondern nur, dass Sie den öffentlichen Schlüssel nicht überprüft haben.
Ausführen des Daemons
Führen Sie den Daemon lokal über eine Befehlszeile aus. Verwenden Sie die Option -o
zur Ausführung im lokalen Modus und -n
zum Festlegen der Region.
~/Downloads$ ./xray -o -n us-east-2
Detaillierte plattformspezifische Anweisungen finden Sie in den folgenden Themen:
-
Linux (lokal) — Den X-Ray-Daemon unter Linux ausführen
-
Windows (lokal) — Den X-Ray-Daemon unter Windows ausführen
-
Elastic Beanstalk — Den X-Ray-Daemon ausführen auf AWS Elastic Beanstalk
-
Amazon EC2 — Den X-Ray-Daemon auf Amazon ausführen EC2
-
Amazon ECS — Den X-Ray-Daemon auf Amazon ECS ausführen
Sie können mithilfe von Befehlszeilenoptionen oder einer Konfigurationsdatei das Verhalten des Daemons anpassen. Details dazu finden Sie unter Konfiguration des AWS X-Ray Daemons.
Dem Daemon die Erlaubnis geben, Daten an X-Ray zu senden
Der X-Ray-Daemon verwendet das AWS SDK, um Trace-Daten auf X-Ray hochzuladen, und benötigt dazu AWS Zugangsdaten mit entsprechender Genehmigung.
Bei Amazon EC2 verwendet der Daemon automatisch die Instance-Profilrolle der Instance. Informationen zu den Anmeldeinformationen, die für die lokale Ausführung des Daemons erforderlich sind, finden Sie unter Lokales Ausführen Ihrer Anwendung.
Wenn Sie an mehreren Orten (Anmeldeinformationsdatei, Instance-Profil oder Umgebungsvariablen) Anmeldeinformationen angeben, bestimmt die SDK-Anbieterkette, welche Anmeldeinformationen verwendet werden. Weitere Informationen zur Bereitstellung von Anmeldeinformationen für das SDK finden Sie unter Spezifying Credentials
Die IAM-Rolle oder der Benutzer, zu der bzw. dem die Anmeldeinformationen des Daemons gehören, benötigt die Berechtigung zum Schreiben von Daten in den Service in Ihrem Namen.
-
Um den Daemon auf Amazon zu verwenden EC2, erstellen Sie eine neue Instance-Profilrolle oder fügen Sie die verwaltete Richtlinie zu einer vorhandenen hinzu.
-
Um den Daemon auf Elastic Beanstalk zu verwenden, fügen Sie die verwaltete Richtlinie der Standard-Instance-Profilrolle von Elastic Beanstalk hinzu.
-
Informationen zum lokalen Ausführen des Daemons finden Sie unter Lokales Ausführen Ihrer Anwendung.
Weitere Informationen finden Sie unter Identitäts- und Zugriffsmanagement für AWS X-Ray.
X-Ray-Daemon-Protokolle
Der Daemon gibt Informationen über seine aktuelle Konfiguration und die Segmente aus, an die er sendet. AWS X-Ray
2016-11-24T06:07:06Z [Info] Initializing AWS X-Ray daemon 2.1.0
2016-11-24T06:07:06Z [Info] Using memory limit of 49 MB
2016-11-24T06:07:06Z [Info] 313 segment buffers allocated
2016-11-24T06:07:08Z [Info] Successfully sent batch of 1 segments (0.123 seconds)
2016-11-24T06:07:09Z [Info] Successfully sent batch of 1 segments (0.006 seconds)
Der Daemon gibt Protokolle standardmäßig an STDOUT aus. Wenn Sie den Daemon im Hintergrund ausführen, verwenden Sie zum Festlegen des Protokolldateipfades die Befehlszeilenoption --log-file
oder eine Konfigurationsdatei. Sie können auch die Protokollierungsebene festlegen und die Protokoll-Rotation deaktivieren. Detaillierte Anweisungen finden Sie unter Konfiguration des AWS X-Ray Daemons.
Auf Elastic Beanstalk legt die Plattform den Speicherort der Daemon-Logs fest. Details dazu finden Sie unter Den X-Ray-Daemon ausführen auf AWS Elastic Beanstalk.