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

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

 

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

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

啟用專案的追蹤

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

注意

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

  • 任何 Lambda 專案。

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

每個AWS CodeStar範本都包含一個建立應用程式AWS執行階段相依性模型的AWS CloudFormation檔案，例如資料庫資料表和 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並開啟AWS CodeStar主控台，網址為 https://console.aws.amazon.com/codestar/。

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

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

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

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

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

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

          Tracing: Active

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

步驟 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 主控台中的追蹤資訊。