啟用專案的追蹤

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

注意

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

• 任何 Lambda 專案。

• 針對 2018 年 8 月 3 日之後建立的 Amazon EC2 或 Elastic Beanstalk 類專案，AWS CodeStar 已為/template.yml檔案。

每個 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 日之後建立的專案，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 主控台中的追蹤資訊。