翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # AWS X-Ray デーモン **注記** X-Ray SDK/デーモンメンテナンス通知 – 2026 年 2 月 25 日、 AWS X-Ray SDKsデーモンはメンテナンスモードに移行します。 AWS では、X-Ray SDK とデーモンのリリースがセキュリティの問題にのみ対処するように制限されます。サポートタイムラインの詳細については、「[X-Ray SDK とデーモンのサポートタイムライン](xray-sdk-daemon-timeline.md)」を参照してください。OpenTelemetry に移行することをお勧めします。OpenTelemetry への移行の詳細については、「[X-Ray による計装から OpenTelemetry による計装への移行](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html)」を参照してください。 **注記** CloudWatch エージェントを使用して Amazon EC2 インスタンスとオンプレミスサーバーからメトリクス、ログ、トレースを収集できます。CloudWatch エージェントバージョン 1.300025.0 以降では、[OpenTelemetry](xray-instrumenting-your-app.md#xray-instrumenting-opentel) または [X-Ray](xray-instrumenting-your-app.md#xray-instrumenting-xray-sdk) クライアント SDK からトレースを収集し、それらを X-Ray に送信できます。 AWS Distro for OpenTelemetry (ADOT) Collector または X-Ray デーモンの代わりに CloudWatch エージェントを使用してトレースを収集することで、管理するエージェントの数を減らすことができます。詳細については、「CloudWatch ユーザーガイド」の「[CloudWatch エージェント](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html)」のトピックを参照してください。 AWS X-Ray デーモンは、UDP ポート 2000 でトラフィックをリッスンし、raw セグメントデータを収集して AWS X-Ray API に中継するソフトウェアアプリケーションです。デーモンは AWS X-Ray SDKs と連携して動作し、SDKs によって送信されたデータが X-Ray サービスに到達できるように実行されている必要があります。X-Ray デーモンは、オープンソースプロジェクトです。プロジェクトに従って、GitHub [github.com/aws/aws-xray-daemon](https://github.com/aws/aws-xray-daemon) で問題とプルリクエストを送信できます。 AWS Lambda および で AWS Elastic Beanstalk、これらのサービスの X-Ray との統合を使用してデーモンを実行します。Lambda は、サンプルリクエスト用に関数が呼び出される度に自動的にデーモンを実行します。Elastic Beanstalk では、[`XRayEnabled`設定オプションを使用](xray-daemon-beanstalk.md)して、環境のインスタンスでデーモンを実行します。詳細については、以下を参照してください。 X-Ray デーモンをローカル、オンプレミス、またはその他の場所で実行するには AWS のサービス、ダウンロードして[実行](#xray-daemon-running)し、セグメントドキュメントを X-Ray にアップロードする[アクセス許可を付与](#xray-daemon-permissions)します。 ## デーモンのダウンロード デーモンは、Amazon S3、Amazon ECR、または Docker Hub からダウンロードしてローカルで実行するか、起動時に Amazon EC2 インスタンスにインストールします。 ------ #### [ Amazon S3 ] **X-Ray デーモンのインストーラおよび実行ファイル** + **Linux (実行可能ファイル)** – [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-3.x.zip](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-3.x.zip) ([sig](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-3.x.zip.sig)) + **Linux (RPM インストーラ)** – [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.rpm](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.rpm) + **Linux (DEB インストーラ)** – [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.deb](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.deb) + **Linux (ARM64、実行可能ファイル)** – [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-arm64-3.x.zip](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-arm64-3.x.zip) ([sig](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-arm64-3.x.zip.sig)) + **Linux（ARM64、RPM インストーラ）** – [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-arm64-3.x.rpm](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-arm64-3.x.rpm) + **Linux (ARM64、DEB インストーラ)** – [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-arm64-3.x.deb](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-arm64-3.x.deb) + **OS X (実行可能ファイル)** – [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-macos-3.x.zip](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-macos-3.x.zip) ([sig](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-macos-3.x.zip.sig)) + **Windows (実行可能ファイル)** – [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-windows-process-3.x.zip](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-windows-process-3.x.zip) ([sig](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-windows-process-3.x.zip.sig)) + **Windows (サービス) ** – [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-windows-service-3.x.zip](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-windows-service-3.x.zip) ([sig](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-windows-service-3.x.zip.sig)) これらのリンクは、常にデーモンの最新の3.xリリースを指しています。特定のリリースをダウンロードするには、以下を実行します。 + バージョン `3.3.0` より前のリリースをダウンロードする場合は、`3.x` をそのバージョン番号に置き換えます。例えば、`2.1.0`。`3.3.0` より前のバージョンでは、使用可能なアーキテクチャは `arm64` のみです。例えば、`2.1.0` と `arm64` です。 + バージョン `3.3.0` より後のリリースをダウンロードする場合は、`3.x` をそのバージョン番号に、`arch` をアーキテクチャタイプに置き換えます。 X-Ray アセットは、サポートされている各リージョンのバケットにレプリケートされます。お客様またはお客様の AWS リソースに最も近いバケットを使用するには、上記のリンクのリージョンをお客様のリージョンに置き換えます。 ``` https://s3.{{us-west-2}}.amazonaws.com/aws-xray-assets.{{us-west-2}}/xray-daemon/{{aws-xray-daemon-3.x.rpm}} ``` ------ #### [ Amazon ECR ] バージョン 3.2.0 以降は、デーモンは[Amazon ECR](https://gallery.ecr.aws/xray/aws-xray-daemon)に掲載されています。イメージを引っ張る前にAmazon ECR パブリックレジストリに[Docker クライアントを認証する](https://docs.aws.amazon.com/AmazonECR/latest/public/public-registries.html#public-registry-auth)必要があります。 次のコマンドを実行して、最新のリリース 3.x バージョンタグを引き出します。 ``` docker pull public.ecr.aws/xray/aws-xray-daemon:3.x ``` 以前のリリースまたはアルファ版は、`3.x`と`alpha`または特定のバージョン番号に置き換えてダウンロードできます。本番環境では、アルファタグ付きのデーモンイメージを使用することは推奨されません。 ------ #### [ Docker Hub ] デーモンは、[Docker Hub](https://hub.docker.com/r/amazon/aws-xray-daemon)で見ることができます。次のコマンドを実行して、最新リリースの3.xバージョンをダウンロードします。 ``` docker pull amazon/aws-xray-daemon:3.x ``` デーモンの以前のリリースは、`3.x`希望のバージョンに置き換えてリリースすることができます。 ------ ## デーモンアーカイブの署名の確認 GPG 署名ファイルは、ZIP アーカイブで圧縮されたデーモンアセットで使用するために含まれています。ホストのパブリックキーは、次の場所にあります。[https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray.gpg](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray.gpg) 公開鍵を使用して、デーモンの ZIP アーカイブがオリジナルで変更されていないことを確認できます。まず、[GnuPG](https://gnupg.org/index.html) で公開鍵をインポートします。 **パブリックキーをインポートするには** 1. 公開鍵をダウンロードします。 ``` $ BUCKETURL=https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2 $ wget $BUCKETURL/xray-daemon/aws-xray.gpg ``` 1. 公開鍵をキーリングにインポートします。 ``` $ gpg --import aws-xray.gpg gpg: /Users/me/.gnupg/trustdb.gpg: trustdb created gpg: key 7BFE036BFE6157D3: public key "AWS X-Ray " imported gpg: Total number processed: 1 gpg: imported: 1 ``` インポートされたキーを使用してデーモンの ZIP アーカイブの署名を確認します。 **アーカイブの署名を確認するには** 1. アーカイブおよび署名ファイルをダウンロードします。 ``` $ 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 ``` 1. `gpg --verify` を実行して署名を確認します｡ ``` $ 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 " 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 ``` 信頼性に関する警告に注意します。自分や信頼する人が署名した場合、鍵は信頼されます。これは、署名が無効であることを意味するものではなく、公開鍵を確認していないことを意味します。 ## デーモンを実行する コマンドラインからローカルでデーモンを実行します。ローカルモードで実行するには `-o` オプションを、リージョンを設定するには `-n` を使用します。 ``` ~/Downloads$ ./xray -o -n us-east-2 ``` プラットフォーム固有の詳細な手順については、以下のトピックを参照してください。 + **Linux (ローカル)** – [Linux で X-Ray デーモンを実行する](xray-daemon-local.md#xray-daemon-local-linux) + **Windows (ローカル)** – [Windows で X-Ray デーモンを実行する](xray-daemon-local.md#xray-daemon-local-windows) + **Elastic Beanstalk** – [での X-Ray デーモンの実行 AWS Elastic Beanstalk](xray-daemon-beanstalk.md) + **Amazon EC2** – [Amazon EC2 での X-Ray デーモンの実行](xray-daemon-ec2.md) + **Amazon ECS** – [Amazon ECS での X-Ray デーモンの実行](xray-daemon-ecs.md) コマンドラインオプションまたは設定ファイルを使用して、デーモンの動作をさらにカスタマイズできます。詳細については、「[AWS X-Ray デーモンの設定](xray-daemon-configuration.md)」を参照してください。 ## X-Rayにデータを送信するアクセス権限をデーモンに付与する X-Ray デーモンは AWS SDK を使用してトレースデータを X-Ray にアップロードするため、そのためのアクセス許可を持つ認証情報が必要です AWS 。 Amazon EC2 では、デーモンはインスタンスのインスタンスプロファイルのロールを自動的に使用します。デーモンをローカルで実行するために必要な認証情報については、「[アプリケーションをローカルで実行する](security_iam_service-with-iam.md#xray-permissions-local)」を参照してください。 1 つ以上の場所 (認証情報ファイル、インスタンスプロファイル、または環境変数) で認証情報を指定する場合、SDK プロバイダーチェーンは、使用される認証情報を決定します。SDK に認証情報を提供する方法の詳細については、[ SDK for Go 開発者ガイド](https://aws.github.io/aws-sdk-go-v2/docs/configuring-sdk/#specifying-credentials)の*AWS 認証情報の指定*を参照してください。 デーモンの認証情報が属している IAM ロールまたはユーザーには、サービスにデータを書き込むアクセス権限が必要です。 + Amazon EC2 でデーモンを使用するには、新しいインスタンスプロファイルのロールを作成するか、既存のロールに管理ポリシーを追加します。 + Elastic Beanstalk でデーモンを使用するには、管理ポリシーを Elastic Beanstalk のデフォルトのインスタンスプロファイルのロールに追加します。 + デーモンをローカルで実行するには、「[アプリケーションをローカルで実行する](security_iam_service-with-iam.md#xray-permissions-local)」を参照してください。 詳細については、「[の ID とアクセスの管理 AWS X-Ray](security-iam.md)」を参照してください。 ## X-Ray デーモンログ デーモンは、現在の設定と送信先のセグメントに関する情報を出力します 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) ``` デフォルトでは、デーモンはログを STDOUT に出力します。デーモンをバックグラウンドで実行する場合は、`--log-file` コマンドラインオプションまたは設定ファイルを使用してログファイルパスを設定します。ログレベルを設定し、ログローテーションを無効にすることもできます。手順については「[AWS X-Ray デーモンの設定](xray-daemon-configuration.md)」を参照してください。 Elastic Beanstalk では、プラットフォームはデーモンログの場所を設定します。詳細については、「[での X-Ray デーモンの実行 AWS Elastic Beanstalk](xray-daemon-beanstalk.md)」を参照してください。