翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# X-Ray の使用開始
<a name="xray-gettingstarted"></a>

**注記**  
X-Ray SDK/デーモンメンテナンス通知 – 2026 年 2 月 25 日、 AWS X-Ray SDKs/Daemon はメンテナンスモードに移行します。 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)」を参照してください。

X-Ray を使用するには、次のステップを実行します。

1. アプリケーションを計測すると、X-Ray はアプリケーションがリクエストを処理する方法を追跡できます。
   + X-Ray SDK、X-Ray API、ADOT、または CloudWatch Application Signals を使用して、トレースデータを X-Ray に送信します。使用するインターフェイスの詳細については、「[インターフェイスの選択](aws-xray-interface.md)」を参照してください。

    計測の詳細については、「[のアプリケーションの計測 AWS X-Ray](xray-instrumenting-your-app.md)」を参照してください。

1. (オプション) X-Ray と統合 AWS のサービス する他の と連携するように X-Ray を設定します。トレースをサンプリングして、受信リクエストにヘッダーを追加し、エージェントまたはコレクターを実行し、トレースデータを X-Ray に自動的に送信できます。詳細については、「[他の AWS X-Ray との統合 AWS のサービス](xray-services.md)」を参照してください。

1. 計測したアプリケーションをデプロイします。アプリケーションがリクエストを受信すると、X-Ray SDK はトレース、セグメント、サブセグメントのデータを記録します。このステップでは、IAM ポリシーをセットアップして、エージェントまたはコレクターをデプロイする必要が生じる場合もあります。
   +  AWS Distro for OpenTelemetry (ADOT) SDK と CloudWatch エージェントを使用してアプリケーションをさまざまなプラットフォームにデプロイするスクリプトの例については、[「Application Signals デモスクリプト](https://github.com/aws-observability/application-signals-demo/tree/main/scripts)」を参照してください。
   + X-Ray SDK と X-Ray デーモンを使用してアプリケーションをデプロイするスクリプトの例については、「[AWS X-Ray サンプルアプリケーション](xray-scorekeep.md)」を参照してください。

1. (オプション) コンソールを開いてデータを表示し分析します。トレースマップ、サービスマップなどの GUI 表現を表示してアプリケーションの機能を確認できます。コンソールのグラフィカルな情報を使用して、アプリケーションを最適化、デバッグ、理解します。コンソールの選択の詳細については、「[コンソールを使用する](aws-xray-interface-console.md)」を参照してください。

次の図は、X-Ray の使用を開始する方法を示しています。

![\[X-Ray は、ステータス、期間、HTTP レスポンスコードなどの、アプリケーションリクエストに関する詳細情報を表示します。\]](http://docs.aws.amazon.com/ja_jp/xray/latest/devguide/images/xray-get-started.png)


コンソールで使用できるデータとマップの例については、トレースデータを生成するために既に計測済みの[サンプルアプリケーション](xray-scorekeep.md)を起動してください。数分で、トラフィックを生成し、セグメントを X-Ray に送信し、トレースとサービスマップを確認できます。