本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# X-Ray 入門
<a name="xray-gettingstarted"></a>

**注意**  
X-Ray 開發套件/協助程式維護通知 – 在 2026 年 2 月 25 日， AWS X-Ray SDKs/協助程式將進入維護模式，其中 AWS 將限制 X-Ray 開發套件和協助程式版本，以僅解決安全問題。如需支援時間軸的詳細資訊，請參閱 [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 SDKs、X-Ray APIs ADOT或 CloudWatch Application Signals 將追蹤資料傳送至 X-Ray。如需使用哪個界面的詳細資訊，請參閱 [選擇界面](aws-xray-interface.md)。

    如需檢測的詳細資訊，請參閱 [檢測您的應用程式 AWS X-Ray](xray-instrumenting-your-app.md)。

1. （選用） 設定 X-Ray 以使用與 X-Ray 整合 AWS 服務 的其他 。您可以取樣追蹤並將標頭新增至傳入請求、執行代理程式或收集器，以及自動將追蹤資料傳送至 X-Ray。如需詳細資訊，請參閱[AWS X-Ray 與其他 整合 AWS 服務](xray-services.md)。

1. 部署經過檢測的應用程式。當您的應用程式收到請求時，X-Ray 開發套件會記錄追蹤、區段和子區段資料。在此步驟中，您可能還必須設定 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/zh_tw/xray/latest/devguide/images/xray-get-started.png)


如需 主控台中可用資料和映射的範例，請啟動已進行檢測以產生追蹤資料[的範例應用程式](xray-scorekeep.md)。在幾分鐘內，您可以產生流量、將區段傳送至 X-Ray，以及檢視追蹤和服務地圖。