啟用專案的追蹤 - AWS CodeStar
步驟 1：編輯 IAM 中的工作者角色以進行追蹤步驟 2：修改 template.yml 檔案以進行追蹤步驟 3：遞交和推送您的範本變更以進行追蹤步驟 4：監視 AWS CloudFormation 堆疊更新以進行追蹤

Amazon Web Services (AWS) 將於 2024 年 7 月 31 日停止支援建立和檢視 AWS CodeStar 專案。2024 年 7 月 31 日之後，您將無法再存取 AWS CodeStar 主控台或建立新專案。不過， 建立 AWS 的資源 AWS CodeStar，包括您的來源儲存庫、管道和組建，將不受此變更影響，且將繼續運作。 AWS CodeStar 連線和 AWS CodeStar 通知不會受此中止的影響。

 

如果您想要追蹤工作、開發程式碼，以及建置、測試和部署應用程式，Amazon CodeCatalyst 會提供簡化的入門程序和其他功能來管理您的軟體專案。進一步了解 Amazon CodeCatalyst 的功能和定價。

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

啟用專案的追蹤

AWS X-Ray 提供追蹤功能，可用來分析分散式應用程式的效能行為 （例如回應時間的延遲）。將追蹤新增至 AWS CodeStar 專案後，您可以使用 AWS X-Ray 主控台來檢視應用程式檢視和回應時間。

注意

您可以對以下專案使用這些步驟，使用下列建立的專案支援變更：

  • 任何 Lambda 專案。

  • 對於 2018 年 8 月 3 日之後建立的 Amazon EC2 或 Elastic Beanstalk 專案， 已在專案儲存庫中佈建/template.yml檔案。 AWS CodeStar

每個 AWS CodeStar 範本都包含一個 AWS CloudFormation 檔案，可建立應用程式 AWS 執行時間相依性的模型，例如資料庫資料表和 Lambda 函數。此檔案存放於檔案 /template.yml 中的來源儲存庫。

您可以將 AWS X-Ray 資源新增至 Resources區段，以修改此檔案來新增追蹤。然後，您可以修改專案的 IAM 許可， AWS CloudFormation 以允許 建立資源。如需範本元素和格式的相關資訊，請參閱AWS 資源類型參考。

這些是自訂範本時可遵循的高階步驟。

  1. 步驟 1：編輯 IAM 中的工作者角色以進行追蹤

  2. 步驟 2：修改 template.yml 檔案以進行追蹤

  3. 步驟 3：遞交和推送您的範本變更以進行追蹤

  4. 步驟 4：監視 AWS CloudFormation 堆疊更新以進行追蹤

步驟 1：編輯 IAM 中的工作者角色以進行追蹤

您必須以系統管理員身分登入，才能執行步驟 1 和 4。此步驟顯示編輯 Lambda 專案許可的範例。

注意

如果您的專案是使用許可界限政策來佈建，則可以略過此步驟。

對於 2018 年 12 月 6 日 PDT 之後建立的專案， 會使用許可界限政策 AWS CodeStar 佈建您的專案。

  1. 登入 AWS Management Console ，並在 https：//https://console.aws.amazon.com/codestar/ 開啟 AWS CodeStar 主控台。

  2. 建立專案或選擇使用 template.yml file 的現有專案，然後開啟 Project resources (​專案資源) 頁面。

  3. 在專案資源，尋找資源清單中為 CodeStarWorker/Lambda 角色建立的 IAM 角色。該角色名稱遵循此格式：role/CodeStarWorker-Project_name-lambda-Function_name。選擇角色的 ARN。

  4. 在 IAM 主控台開啟該角色。選擇連接政策。搜尋 AWSXrayWriteOnlyAccess 政策，選取旁邊的方框，然後選擇 Attach Policy (連接政策)。

步驟 2：修改 template.yml 檔案以進行追蹤

  1. 開啟 AWS CodeStar 主控台，網址為 https://console.aws.amazon.com/codestar/：//。

  2. 選擇您的無伺服器專案，然後開啟程式碼頁面。在儲存庫的最上層，尋找和編輯 template.yml 檔案。在 Resources 下方將資源貼到 Properties 部分。

          Tracing: Active

    此範例顯示修改過的範本：

    AWS Serverless Function configuration with X-Ray tracing enabled for the GetHelloWorld function.

步驟 3：遞交和推送您的範本變更以進行追蹤

  • 遞交和推送 template.yml 檔案中的變更。

    注意

    此會啟動您的管道。如果您在更新 IAM 許可之前遞交變更，您的管道會啟動、 AWS CloudFormation 堆疊更新發生錯誤，且堆疊更新會復原。如果發生這種情況，請修正權限，然後重新啟動您的管道。

步驟 4：監視 AWS CloudFormation 堆疊更新以進行追蹤

  1. 當專案的管道啟動部署階段時， AWS CloudFormation 堆疊更新就會開始。若要查看堆疊更新的狀態，請在 AWS CodeStar 儀表板上選擇管道中的 AWS CloudFormation 階段。

    如果 中的堆疊更新 AWS CloudFormation 傳回錯誤，請參閱 中的疑難排解準則AWS CloudFormation：遺失許可的回復建立堆疊。如果工作者角色遺漏許可，請編輯連接到您專案的 Lambda 工作者角色的政策。請參閱 步驟 1：編輯 IAM 中的工作者角色以進行追蹤。

  2. 使用儀表板檢視成功完成的管道。您的應用程式現已啟用追蹤功能。

  3. 在 Lambda 主控台檢視您的函數詳細資訊，確認追蹤功能已啟用。

  4. 選擇專案的應用程式端點。與您應用程式的這項互動會被追蹤。您可以檢視 AWS X-Ray 主控台中的追蹤資訊。

    Trace list showing two entries with ID, Age, Method, Response, and Response time columns.