使用開發套件 - AWS X-Ray

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

使用開發套件

如果您想要使用命令列介面,或者需要更多的自訂追蹤、監視或記錄功能,請使用 SDK AWS Management Console。您也可以使用 AWS SDK 來開發使用 X-Ray API 的程式。您可以使用適用於 OpenTelemetry (ADOT)SDK 的發行 AWS 版或 X-Ray SDK。

如果您使用 SDK,則可以在檢測應用程式時以及設定收集器或代理程式時,將自訂新增至工作流程。您可以使用 SDK 執行以下無法使用的任務 AWS Management Console:

  • 發佈自訂指標 — 以低至 1 秒的高解析度取樣指標、使用多個維度新增有關量度的資訊,以及將資料點彙總至統計集。

  • 自訂您的收集器 — 自訂收集器任何部分的組態,包括接收器、處理器、匯出器和連接器。

  • 自訂您的檢測 — 自訂區段和子區段、新增自訂索引鍵值配對作為屬性,以及建立自訂指標。

  • 以編程方式創建和更新採樣規則。

如果您想要彈性地使用標準化 OpenTelemetry SDK,並提供額外的 AWS 安全性和最佳化層級,請使用 SDK。ADOT AWS Distro for OpenTelemetry (ADOT) SDK 是一個與供應商無關的套件,可與其他廠商和非AWS 服務的後端整合,而無需重新檢測您的程式碼。

如果您已經在使用 X-Ray SDK,只與 AWS 後端整合,而且不想變更與 X-Ray 或應用程式程式碼互動的方式,請使用 X-Ray SDK。

如需每個功能的詳細資訊,請參閱在 AWS 發行版 OpenTelemetry 和 X-Ray SDK 之間進行選擇

使用ADOT開發套件

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

如果您使用的是 ADOT SDK,則可以使用下列選項與代理程式搭配使用:

  • 搭配CloudWatch 代理程式使用 ADOT SDK — 建議使用。

  • 搭配ADOT收集器使用 ADOT SDK — 如果您想要使用具有安全性和最佳化 AWS 層級的廠商無關軟體,建議使用此功能。

若要使用 ADOT SDK,請執行下列動作:

收ADOT集器收到您的資料後,會將其傳送至您在ADOT設定中指定的後端。 ADOT可以將數據發送到多個後端,包括以外的供應商 AWS,如下圖所示:

您可以在檢測應用程式並設定收集器時自訂 ADOT 收集器。

AWS 定期更新ADOT以添加功能並與OpenTelemetry框架保持一致。更新和 future 的開發計劃ADOT是向公眾提供的藍圖的一部分。 ADOT支持多種編程語言,其中包括以下內容:

  • Go

  • Java

  • JavaScript

  • Python

  • .NET

  • Ruby

  • PHP

如果您使用的是 Python,ADOT可以自動檢測您的應用程序。若要開始使用ADOT,請參閱適用於 OpenTelemetry 收集器的 AWS 發行版簡介和入門

使用X-Ray開發套件

X-Ray SDK 是一組 AWS API 和程式庫,可將資料傳送至 AWS 後端服務。使用 X-Ray SDK 來檢測您的應用程式並收集追蹤資料。您無法使用 X-Ray SDK 收集記錄檔或量度資料。

如果您使用的是 X-Ray SDK,則搭配代理程式可提供下列選項:

  • 搭配使用 X-Ray SDK AWS X-Ray 守護進 — 如果您不想更新應用程式程式碼,請使用此選項。

  • 搭配 CloudWatch 代理程式使用 X-Ray SDK — (建議) CloudWatch 代理程式與 X-Ray SDK 相容。

若要使用 X-Ray SDK,請執行下列動作:

  • 使用 X-Ray SDK 檢測您的應用程式。

  • 設定收集器,告訴收集器將收集的資料傳送到何處。您可以使用 CloudWatch 代理程式或 X-Ray 精靈來收集追蹤資訊。

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

搭配 CloudWatch 代理程式或 X-Ray 精靈使用 X-Ray SDK。

如果您使用的是Java,您可以使用 X-Ray SDK 自動檢測您的應用程式。若要開始使用 X-Ray SDK,請參閱與下列程式設計語言相關聯的程式庫: