X-Ray 入門

注意

End-of-support通知 – 在 2027 年 2 月 25 日， AWS X-Ray 將停止支援 AWS X-Ray SDKs 和協助程式。2027 年 2 月 25 日之後，您將不再收到更新或版本。如需支援時間表的詳細資訊，請參閱 X-Ray SDK 和協助程式終止支援時間表。建議您遷移至 OpenTelemetry。如需遷移至 OpenTelemetry 的詳細資訊，請參閱從 X-Ray 檢測遷移至 OpenTelemetry 檢測。

若要使用 X-Ray，請執行下列步驟：

1. 檢測您的應用程式，這可讓 X-Ray 追蹤您的應用程式如何處理請求。

   • 使用 X-Ray SDKs、X-Ray APIs ADOT或 CloudWatch Application Signals 將追蹤資料傳送至 X-Ray。如需使用哪個界面的詳細資訊，請參閱 選擇界面。

   如需檢測的詳細資訊，請參閱 檢測您的應用程式 AWS X-Ray。

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

3. 部署經過檢測的應用程式。當您的應用程式收到請求時，X-Ray 開發套件會記錄追蹤、區段和子區段資料。在此步驟中，您可能還必須設定 IAM 政策並部署代理程式或收集器。

   • 如需在不同平台上使用 AWS Distro for OpenTelemetry (ADOT) SDK 和 CloudWatch 代理程式部署應用程式的範例指令碼，請參閱 Application Signals 示範指令碼。

   • 如需使用 X-Ray SDK 和 X-Ray 協助程式部署應用程式的範例指令碼，請參閱 AWS X-Ray 範例應用程式。

4. （選用） 開啟主控台以檢視和分析資料。您可以查看追蹤映射、服務映射等的 GUI 表示法，以檢查應用程式的運作方式。使用主控台中的圖形資訊來最佳化、偵錯和了解您的應用程式。如需選擇主控台的詳細資訊，請參閱 使用主控台。

下圖顯示如何開始使用 X-Ray：

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