本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用 SDK
SDK如果您想要使用命令列介面,或者需要比中可用的更多自訂追蹤、監視或記錄功能,請使用 AWS Management Console。您也可以使用 AWS SDK開發使用 X-Ray 的程式APIs。您可以將 AWS 發行版用於 OpenTelemetry (ADOT)SDK或 X-Ray SDK。
如果您使用SDK,則可以在檢測應用程式時以及設定收集器或代理程式時,將自訂新增至工作流程。您可以使用SDK來執行以下無法使用的任務 AWS Management Console:
-
發佈自訂指標 — 以低至 1 秒的高解析度取樣指標、使用多個維度新增有關量度的資訊,以及將資料點彙總至統計集。
-
自訂您的收集器 — 自訂收集器任何部分的組態,包括接收器、處理器、匯出器和連接器。
-
自訂您的檢測 — 自訂區段和子區段、新增自訂索引鍵值組作為屬性,以及建立自訂指標。
-
以編程方式創建和更新採樣規則。
ADOTSDK如果您想要使用標OpenTelemetrySDK準化的 AWS 安全性和最佳化層的彈性,請使用。 AWS Distro to OpenTelemetry (ADOT) SDK 是與供應商無關的套件,可與其他廠商和非AWS 服務的後端整合,而無需重新檢測您的程式碼。
SDK如果您已經在使用 X-RaySDK,只與 AWS 後端集成,並且不想更改與 X-Ray 或應用程序代碼的互動方式,請使用 X-Ray。
如需每個功能的詳細資訊,請參閱在 AWS 發行版 OpenTelemetry 和 X-Ray 之間進行選擇 SDKs。
使用 ADOT SDK
這ADOTSDK是一組開放原始碼APIs、程式庫和代理程式,可將資料傳送至後端服務。 ADOT受到多個後端和代理程式的支援、整合,並提供OpenTelemetry社群維護的大量開放原始碼程式庫。 AWS使用ADOTSDK來檢測您的應用程式並收集記錄、中繼資料、指標和追蹤。您也可以使ADOT用監控服務並根據中的指標設定警示 CloudWatch。
如果您使用的是 ADOTSDK,您可以使用下列選項與代理程式搭配使用:
-
與CloudWatch 代理程式ADOTSDK搭配使用 — 建議使用。
-
與ADOT收集器
一ADOTSDK起使用 — 如果您想要使用具有安全性和最佳化 AWS 層級的廠商無關軟體,建議使用此功能。
若要使用 ADOTSDK,請執行下列動作:
-
使用檢測您的應用程式ADOTSDK。如需詳細資訊,請參閱ADOT技術文件中的程式設計語言文件
。 -
設定收ADOT集器,告訴收集器將收集的資料傳送到何處。
收ADOT集器收到您的資料後,會將其傳送至您在ADOT設定中指定的後端。 ADOT可以將數據發送到多個後端,包括以外的供應商 AWS,如下圖所示:
AWS 定期更新ADOT以添加功能並與OpenTelemetry
-
Go
-
Java
-
JavaScript
-
Python
-
.NET
-
Ruby
-
PHP
如果您使用的是 Python,ADOT可以自動檢測您的應用程序。若要開始使用ADOT,請參閱適用於 OpenTelemetry 收集器的 AWS 發行版簡介
使用 X-Ray SDK
X-Ray SDK 是一組 AWS APIs和庫,可將數據發送到 AWS 後端服務。使用 X-Ray 檢SDK測您的應用程式並收集追蹤資料。您無法使用 X-Ray SDK 來收集記錄檔或量度資料。
如果您使用的是 X-RaySDK,您可以選擇以下選項,與代理程式結合使用:
-
使用 X-Ray SDK 與 AWS X-Ray 守護進 — 如果您不想更新您的應用程序代碼,請使用此選項。
-
使用 X-Ray SDK 與 CloudWatch 代理 — (推薦) 該 CloudWatch 劑與 X-Ray 兼容SDK.
要使用 X-RaySDK,請執行以下操作:
-
使用 X-Ray 檢測您的應用程序SDK。
-
設定收集器,告訴收集器將收集的資料傳送到何處。您可以使用 CloudWatch 代理程式或 X-Ray 精靈來收集追蹤資訊。
收集器或代理程式收到您的資料後,會將其傳送至您在代理程式組態中指定的後 AWS 端。X-Ray 只SDK能將數據發送到 AWS 後端,如下圖所示:
如果您使用的是Java,您可以使用 X-Ray 自動SDK檢測您的應用程式。若要開始使用 X-RaySDK,請參閱與下列程式設計語言相關的程式庫: