本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
設定 AWS X-Ray 除錯
您可以使用 AWS Elastic Beanstalk 主控台或組態檔案,對您環境中的執行個體執行 AWS X-Ray 常駐程式。X-Ray 是一項 AWS 服務,可蒐集您應用程式提供請求的資料,並使用此資料建構服務地圖,藉以辨識應用程式的問題與最佳化的機會。
注意
部分區域未提供 X-Ray。若您於這些區域的其中之一建立環境,將無法在環境中的執行個體上執行 X-Ray 協助程式。
如需各區域提供的 AWS 服務的資訊,請參閱區域表
X-Ray 提供了可用於檢測應用程式程式碼的軟體開發套件,以及一個將偵錯資訊從軟體開發套件轉送至 X-Ray API 的協助程式應用程式。
支援的平台
您可以搭配下列 Elastic Beanstalk 平台使用 X-Ray 開發套件:
-
Go - 2.9.1 版及更新版本
-
Java 8 - 2.3.0 版和更新版本
-
Java 8 搭配 Tomcat 8 - 2.4.0 版和更新版本
-
Node.js - 3.2.0 版和更新版本
-
Windows Server - 所有在 2016 年 12 月 18 日或其之後發行的平台版本
-
Python - 2.5.0 版和更新版本
您可以在支援的平台上透過組態選項,於環境中的執行個體上執行 X-Ray 協助程式。您可於 Elastic Beanstalk 主控台或透過使用組態檔案來啟用協助程式。
為了將資料上傳至 X-Ray,X-Ray 協助程式需要在 AWSXrayWriteOnlyAccess 受管政策中具備 IAM 許可。這些許可包含在 Elastic Beanstalk 執行個體描述檔中。如果您不使用預設執行個體描述檔,請參閱《AWS X-Ray 開發人員指南》中的授予常駐程式將資料傳送至 X-Ray 的許可。
使用 X-Ray 進行偵錯需要使用 X-Ray 開發套件。如需說明和範例應用程式,請參閱《AWS X-Ray 開發人員指南》中的 AWS X-Ray 入門。
若您使用不含精靈的平台版本,您仍可在組態檔案中透過指令碼執行它。如需詳細資訊,請參閱《AWS X-Ray 開發人員指南》中的手動下載及執行 X-Ray 常駐程式 (進階)。
設定除錯
您可以在 Elastic Beanstalk 主控台中於正在執行的環境上啟用 X-Ray 協助程式。
在 Elastic Beanstalk 主控台中啟用偵錯
開啟 Elastic Beanstalk 主控台
,然後在 Regions (區域) 清單中選取您的 AWS 區域。 -
在導覽窗格中,選擇 Environments (環境),然後在清單中選擇您環境的名稱。
注意
如果您有許多環境,請使用搜尋列來篩選環境清單。
在導覽窗格中,選擇 Configuration (組態)。
-
在更新、監控和日誌記錄組態類別中,選擇編輯。
-
在 Amazon X-Ray 區段中,選取已啟動。
-
若要儲存變更,請選擇頁面底部的儲存變更。
您亦可於環境建立期間啟用此選項。如需更多詳細資訊,請參閱 建立新的環境精靈。
aws:elasticbeanstalk:xray 命名空間
您可於 XRayEnabled
命名空間使用 aws:elasticbeanstalk:xray
選項,以啟用除錯。
欲在您部署應用程式時自動啟用除錯,請於原始碼的組態檔案中設定選項,如下所示。
範例 .ebextensions/debugging.config
option_settings:
aws:elasticbeanstalk:xray:
XRayEnabled: true