設定 AWS X-Ray 除錯 - AWS Elastic Beanstalk

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

設定 AWS X-Ray 除錯

您可以使用 AWS Elastic Beanstalk 主控台或組態檔案,對您環境中的執行個體執行 AWS X-Ray 常駐程式。X-Ray 是一項 AWS 服務,可蒐集您應用程式提供請求的資料,並使用此資料建構服務地圖,藉以辨識應用程式的問題與最佳化的機會。

注意

部分區域未提供 X-Ray。若您於這些區域的其中之一建立環境,將無法在環境中的執行個體上執行 X-Ray 協助程式。

如需各區域提供的 AWS 服務的資訊,請參閱區域表

使用 Amazon DynamoDB 存放資料的 Web API 應用程式服務地圖

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 主控台中啟用偵錯
  1. 開啟 Elastic Beanstalk 主控台,然後在 Regions (區域) 清單中選取您的 AWS 區域。

  2. 在導覽窗格中,選擇 Environments (環境),然後在清單中選擇您環境的名稱。

    注意

    如果您有許多環境,請使用搜尋列來篩選環境清單。

  3. 在導覽窗格中,選擇 Configuration (組態)

  4. 更新、監控和日誌記錄組態類別中,選擇編輯

  5. Amazon X-Ray 區段中,選取已啟動

  6. 若要儲存變更,請選擇頁面底部的儲存變更

您亦可於環境建立期間啟用此選項。如需更多詳細資訊,請參閱 建立新的環境精靈

aws:elasticbeanstalk:xray 命名空間

您可於 XRayEnabled 命名空間使用 aws:elasticbeanstalk:xray 選項,以啟用除錯。

欲在您部署應用程式時自動啟用除錯,請於原始碼的組態檔案中設定選項,如下所示。

範例 .ebextensions/debugging.config
option_settings: aws:elasticbeanstalk:xray: XRayEnabled: true