Konfigurieren des AWS X-Ray Daemon - AWS X-Ray
Unterstützte UmgebungsvariablenVerwenden von BefehlszeilenoptionenVerwendung einer Konfigurationsdatei

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.

Konfigurieren des AWS X-Ray Daemon

Sie können Befehlszeilenoptionen oder eine Konfigurationsdatei verwenden, um das Verhalten des X-Ray-Daemons anzupassen. Die meisten Optionen sind bei beiden Methoden verfügbar. Manche sind jedoch nur in Form von Konfigurationsdateien oder nur in der Befehlszeile verfügbar.

Um zu beginnen, müssen Sie -n nur oder kennen--region, mit der Sie die Region festlegen, die der Daemon zum Senden von Ablaufverfolgungsdaten an X-Ray verwendet.

~/xray-daemon$ ./xray -n us-east-2

Wenn Sie den Daemon lokal ausführen, d. h. nicht auf Amazon EC2, können Sie die -o Option hinzufügen, die Überprüfung auf Instance-Profilanmeldeinformationen zu überspringen, damit der Daemon schneller bereit wird.

~/xray-daemon$ ./xray -o -n us-east-2

Mithilfe der restlichen Befehlszeilenoptionen können Sie die Protokollierung konfigurieren, einen anderen Port abhören, die vom Daemon nutzbare Speichermenge begrenzen oder eine Rolle annehmen, um Ablaufverfolgungsdaten an ein anderes Konto zu senden.

Sie können eine Konfigurationsdatei an den Daemon übergeben, um auf erweiterte Konfigurationsoptionen zuzugreifen und beispielsweise die Anzahl gleichzeitiger Aufrufe an X-Ray zu begrenzen, die Protokollrotation zu deaktivieren und Datenverkehr an einen Proxy zu senden.

Unterstützte Umgebungsvariablen

Der X-Ray-Daemon unterstützt die folgenden Umgebungsvariablen:

  • AWS_REGION – Gibt die AWS-Region des X-Ray-Service-Endpunkts an.

  • HTTPS_PROXY – Gibt eine Proxy-Adresse an, über die der Daemon Segmente hochladen kann. Dies können entweder die DNS-Domänennamen oder die IP-Adressen und Portnummern sein, die von Ihren Proxy-Servern verwendet werden.

Verwenden von Befehlszeilenoptionen

Übergeben Sie diese Optionen an den Daemon, wenn Sie ihn lokal oder mit einem Benutzerdatenskript ausführen.

Befehlszeilenoptionen

  • -b, --bind – Achten Sie auf Segmentdokumente auf einem anderen UDP-Port.

    --bind "127.0.0.1:3000"

    Standard – 2000.

  • -t, --bind-tcp – Horcht auf Aufrufe des X-Ray-Service auf einem anderen TCP-Port.

    -bind-tcp "127.0.0.1:3000"

    Standard – 2000.

  • -c, --config – Laden Sie eine Konfigurationsdatei aus dem angegebenen Pfad.

    --config "/home/ec2-user/xray-daemon.yaml"

  • -f, --log-file – Ausgabeprotokolle an den angegebenen Dateipfad.

    --log-file "/var/log/xray-daemon.log"

  • -l, --log-level – Protokollebene, vom ausführlichsten zum geringsten: dev, debug, info, warningn, error, prod.

    --log-level warn

    Standard – prod

  • -m, --buffer-memory – Ändern Sie die Speichermenge in MB, die Puffer verwenden können (mindestens 3).

    --buffer-memory 50

    Standard – 1 % des verfügbaren Speichers.

  • -o, --local-mode – Überprüfen Sie nicht auf EC2-Instance-Metadaten.

  • -r, --role-arn – Übernehmen Sie die angegebene IAM-Rolle, um Segmente in ein anderes Konto hochzuladen.

    --role-arn "arn:aws:iam::123456789012:role/xray-cross-account"

  • -a, --resource-arn – Amazon-Ressourcenname (ARN) der AWS Ressource, auf der der Daemon ausgeführt wird.

  • -p, --proxy-address – Laden Sie Segmente AWS X-Ray über einen Proxy in hoch. Das Protokoll des Proxyservers muss angegeben werden.

    --proxy-address "http://192.0.2.0:3000"

  • -n, --region – Senden Sie Segmente an den X-Ray-Service in einer bestimmten Region.

  • -v, --version – Zeigt die AWS X-Ray Daemon-Version an.

  • -h, --help – Zeigt den Hilfebildschirm an.

Verwendung einer Konfigurationsdatei

Sie können auch eine Datei im YAML-Format zur Konfiguration des Daemons verwenden. Übergeben Sie die Konfigurationsdatei mit der -c-Option an den Daemon.

~$ ./xray -c ~/xray-daemon.yaml
Konfigurationsdateioptionen

  • TotalBufferSizeMB – Maximale Puffergröße in MB (mindestens 3). Wählen Sie 0, um 1 % des Host-Speichers zu verwenden.

  • Concurrency – Maximale Anzahl gleichzeitiger Aufrufe an AWS X-Ray , um Segmentdokumente hochzuladen.

  • Region – Senden Sie Segmente an den AWS X-Ray Service in einer bestimmten Region.

  • Socket – Konfigurieren Sie die Bindung des Daemon.

    • UDPAddress – Ändern Sie den Port, den der Daemon überwacht.

    • TCPAddress – Horcht auf Aufrufe des X-Ray-Service auf einem anderen TCP-Port.

  • Logging – Konfigurieren Sie das Protokollierungsverhalten.

    • LogRotation – Setzen Sie diesen Wert auf false, um die Protokollrotation zu deaktivieren.

    • LogLevel – Ändern Sie die Protokollebene von am ausführlichsten zu am wenigsten: devdebug, info oder prod, warn, error, , prod. Der Standardwert ist prod, was entsprichtinfo.

    • LogPath – Ausgabeprotokolle an den angegebenen Dateipfad.

  • LocalMode – Setzen Sie diesen Wert auf true, um die Überprüfung auf EC2-Instance-Metadaten zu überspringen.

  • ResourceARN – Amazon-Ressourcenname (ARN) der AWS Ressource, auf der der Daemon ausgeführt wird.

  • RoleARN – Übernehmen Sie die angegebene IAM-Rolle, um Segmente in ein anderes Konto hochzuladen.

  • ProxyAddress – Laden Sie Segmente AWS X-Ray über einen Proxy in hoch.

  • Endpoint – Ändern Sie den X-Ray-Service-Endpunkt, an den der Daemon Segmentdokumente sendet.

  • NoVerifySSL – Deaktivieren Sie die Verifizierung des TLS-Zertifikats.

  • Version – Version des Daemon-Konfigurationsdateiformats. Die Dateiformatversion ist ein Pflichtfeld.

Beispiel Xray-daemon.yaml

In dieser Konfigurationsdatei wird der Listening-Port des Daemons in 3000 geändert. Dazu werden die Prüfungen auf Instance-Metadaten deaktiviert, eine Rolle für den Upload von Segmenten eingerichtet und die Optionen für Region und Protokollierung geändert.

Socket:
  UDPAddress: "127.0.0.1:3000"
  TCPAddress: "127.0.0.1:3000"
Region: "us-west-2"
Logging:
  LogLevel: "warn"
  LogPath: "/var/log/xray-daemon.log"
LocalMode: true
RoleARN: "arn:aws:iam::123456789012:role/xray-cross-account"
Version: 2