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

# 使用 SDK
<a name="aws-xray-interface-sdk"></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)。

如果您想要使用命令列界面，或比 中可用的功能需要更多自訂追蹤、監控或記錄功能，請使用 開發套件 AWS 管理主控台。您也可以使用 AWS SDK 來開發使用 X-Ray APIs程式。您可以使用 AWS Distro for OpenTelemetry (ADOT) 開發套件或 X-Ray 開發套件。

如果您使用 SDK，您可以在檢測應用程式和設定收集器或代理程式時，將自訂新增至工作流程。您可以使用 SDK 來執行無法使用 執行的下列任務 AWS 管理主控台：
+ 發佈自訂指標 – 高解析度低至 1 秒的範例指標，使用多個維度來新增指標的相關資訊，並將資料點彙總至統計資料集。
+ 自訂您的收集器 – 自訂收集器任何部分的組態，包括接收者、處理器、匯出器和連接器。
+ 自訂您的檢測 – 自訂區段和子區段、新增自訂鍵值對做為屬性，以及建立自訂指標。
+ 以程式設計方式建立和更新抽樣規則。

如果您想要彈性地使用標準 ADOT SDK 並新增多層 AWS 安全性和最佳化，請使用 OpenTelemetry SDK。 AWS Distro for OpenTelemetry (ADOT) SDK 是與廠商無關的套件，允許與其他廠商和非AWS 服務的後端整合，而無需重新檢測您的程式碼。

如果您已經在使用 X-Ray 開發套件、僅與 AWS 後端整合，而且不想變更您與 X-Ray 或應用程式程式碼互動的方式，請使用 X-Ray 開發套件。

如需每個功能的詳細資訊，請參閱 [選擇 AWS Distro for OpenTelemetry 和 X-Ray SDKs](xray-instrumenting-your-app.md#xray-instrumenting-choosing)。

## 使用 ADOT SDK
<a name="aws-xray-interface-sdk-adot"></a>

SDK ADOT是一組開放原始碼 APIs、程式庫和代理程式，可將資料傳送至後端服務。 ADOT 受 支援 AWS、與多個後端和代理程式整合，並提供OpenTelemetry社群維護的大量開放原始碼程式庫。使用 ADOT 開發套件來檢測您的應用程式，並收集日誌、中繼資料、指標和追蹤。您也可以使用 ADOT 來監控服務，並根據 CloudWatch 中的指標設定警示。

如果您使用 ADOT開發套件，您可以搭配 代理程式使用下列選項：
+ 搭配 [CloudWatch 代理程式](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html)使用 ADOT SDK – 建議使用。
+ 搭配 [ADOT Collector](https://aws-otel.github.io/docs/getting-started/collector) 使用 ADOT 開發套件 – 如果您想要搭配 AWS 多層安全性和最佳化使用與廠商無關的軟體，建議使用 。

若要使用 ADOT SDK，請執行下列動作：
+ 使用 ADOT SDK 檢測您的應用程式。如需詳細資訊，請參閱 [ADOT 技術文件中程式設計語言的文件](https://aws-otel.github.io/docs/introduction)。
+ 設定ADOT收集器以告知收集資料的位置。

ADOT 收集器收到您的資料後，會將其傳送至您在ADOT組態中指定的後端。 ADOT可以將資料傳送至多個後端，包括 以外的廠商 AWS，如下圖所示：

![\[您可以在檢測應用程式和設定收集器時自訂 ADOT 收集器。\]](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/adot-sdk.png)


AWS 會定期更新ADOT以新增功能，並與 [OpenTelemetry](https://opentelemetry.io/docs/) 架構保持一致。開發的更新和未來計劃ADOT是可供公眾使用的[藍圖](https://github.com/orgs/aws-observability/projects/4)的一部分。 ADOT支援多種程式設計語言，包括下列項目：
+ Go
+ Java
+ JavaScript
+ Python
+ .NET
+ Ruby
+ PHP

如果您使用的是 Python， ADOT 可以自動檢測您的應用程式。若要開始使用 ADOT，請參閱 Distro for OpenTelemetry Collector [簡介](https://aws-otel.github.io/docs/introduction)和入門。 [AWS OpenTelemetry ](https://aws-otel.github.io/docs/getting-started/collector)

## 使用 X-Ray SDK
<a name="aws-xray-interface-sdk-xray"></a>

X-Ray SDK 是一組 AWS APIs和程式庫，可將資料傳送至 AWS 後端服務。使用 X-Ray 開發套件來檢測您的應用程式並收集追蹤資料。您無法使用 X-Ray 開發套件來收集日誌或指標資料。

如果您使用 X-Ray 開發套件，您可以搭配 代理程式使用下列選項：
+ 搭配 使用 X-Ray 開發套件 [AWS X-Ray 協助程式](xray-daemon.md) – 如果您不想更新應用程式碼，請使用此選項。
+ 搭配 CloudWatch 代理程式使用 X-Ray 開發套件 – （建議） CloudWatch 代理程式與 X-Ray 開發套件相容。

若要使用 X-Ray 開發套件，請執行下列動作：
+ 使用 X-Ray SDK 檢測您的應用程式。
+ 設定收集器以告知收集資料的位置。您可以使用 CloudWatch 代理程式或 X-Ray 協助程式來收集追蹤資訊。

收集器或代理程式收到您的資料後，會將其傳送至您在代理程式組態中指定的 AWS 後端。X-Ray SDK 只能將資料傳送至 AWS 後端，如下圖所示：

![\[搭配 CloudWatch 代理程式或 X-Ray 協助程式使用 X-Ray 開發套件。\]](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/xray-sdk.png)


如果您使用的是 Java，您可以使用 X-Ray 開發套件自動檢測您的應用程式。若要開始使用 X-Ray 開發套件，請參閱與下列程式設計語言相關聯的程式庫：
+ [Go](xray-go.md)
+ [Java](xray-java.md)
+ [Node.js](xray-nodejs.md)
+ [Python](xray-python.md)
+ [.NET](xray-dotnet.md)
+ [Ruby](xray-ruby.md)