Konfigurieren des AWS X-Ray-Daemons - 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.

Konfigurieren des AWS X-Ray-Daemons

Sie können mithilfe von Befehlszeilenoptionen oder einer Konfigurationsdatei das Verhalten des X-Ray-Daemons anpassen. 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 loszulegen, ist die einzige Option, die Sie wissen müssen-noder--region, die Sie verwenden, um die Region festzulegen, 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, um die Überprüfung auf Anmeldeinformationen des Instance-Profils zu überspringen. Der Daemon ist somit schneller bereit.

~/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 weiterleiten, um auf erweiterte Konfigurationsoptionen zuzugreifen und bestimmte Aktivitäten, wie Begrenzen der Anzahl gleichzeitiger Aufrufe von X-Ray, Deaktivieren der Protokoll-Rotation und Senden von Datenverkehr an einen Proxy auszuführen.

Unterstützte Umgebungsvariablen

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

  • AWS_REGION— Gibt dieAWSRegiondes X-Ray-Service-Endpunkts.

  • HTTPS_PROXY— Gibt eine Proxy-Adresse an, über die der Daemon Segmente hochladen soll. 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- Warten auf Segmentdokumente auf einem anderen UDP-Port.

    --bind "127.0.0.1:3000"

    Standard —2000aus.

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

    -bind-tcp "127.0.0.1:3000"

    Standard —2000aus.

  • -c,--config— Laden einer Konfigurationsdatei aus dem angegebenen Pfad.

    --config "/home/ec2-user/xray-daemon.yaml"
  • -f,--log-file— Geben Sie Protokolle in den angegebenen Dateipfad aus.

    --log-file "/var/log/xray-daemon.log"
  • -l,--log-level- Protokollierungsebene, von der höchsten bis zur niedrigsten: dev, debug, info, warn, error, prod.

    --log-level warn

    Standard —prod

  • -m,--buffer-memory- Ändern Sie die Größe des Speichers in MB, den die Puffer verwenden können (Minimum 3).

    --buffer-memory 50

    Standard - 1% des verfügbaren Arbeitsspeichers.

  • -o,--local-mode- Es wird nicht auf EC2-Instance-Metadaten geprüft.

  • -r,--role-arn— Nehmen die angegebene IAM-Rolle zum Hochladen von Segmenten auf ein anderes Konto an.

    --role-arn "arn:aws:iam::123456789012:role/xray-cross-account"
  • -a,--resource-arn— Amazon-Ressourcenname (ARN) desAWS-Ressource, die den Daemon ausführt.

  • -p,--proxy-address— Segmente hochladen aufAWS X-Raydurch einen Proxy. Das Protokoll des Proxyservers muss angegeben werden.

    --proxy-address "http://192.0.2.0:3000"
  • -n,--region— Senden Segmente an den X-Ray-Service in einer bestimmten Region.

  • -v,--version— ZeigenAWS X-Ray-Daemon-Version.

  • -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 (Minimum 3). Wählen Sie 0, um 1 % des Host-Speichers zu verwenden.

  • Concurrency- Maximale Anzahl gleichzeitiger Aufrufe vonAWS X-Rayum Segmentdokumente hochzuladen.

  • Region— Segmente senden anAWS X-Ray-Service in einer bestimmten Region.

  • Socket— Konfiguriert die Bindung des Daemons.

    • UDPAddress- Ändern Sie den Port, an dem der Daemon lauscht.

    • TCPAddress— Wartet aufAufrufe des X-Ray-Serviceauf einem anderen TCP-Port.

  • Logging- Konfiguriert das Protokollierungsverhalten.

    • LogRotation— Stellen Sie auffalseum die Protokollrotation zu deaktivieren.

    • LogLevel- Ändern Sie die Protokollierungsebene, von der höchsten bis zur niedrigsten: dev,debug,info,warn,error,prodaus. Der Standardwert istprod, was gleich istinfoaus.

    • LogPath— Geben Sie Protokolle in den angegebenen Dateipfad aus.

  • LocalMode— Stellen Sie auftrueum die Überprüfung auf EC2-Instance-Metadaten zu überspringen.

  • ResourceARN— Amazon-Ressourcenname (ARN) desAWS-Ressource, die den Daemon ausführt.

  • RoleARN— Nehmen die angegebene IAM-Rolle zum Hochladen von Segmenten auf ein anderes Konto an.

  • ProxyAddress— Segmente hochladen aufAWS X-Raydurch einen Proxy.

  • Endpoint— Ändern des X-Ray-Service-Endpunkts, an den der Daemon Segmentdokumente sendet.

  • NoVerifySSL- Deaktivieren der Überprüfung des TLS-Zertifikats.

  • Version— Dateiformatversion der Daemon-Konfiguration. Die Dateiformatversion ist eineerforderlichfield.

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