本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
啟用專案的追蹤
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:編輯 IAM 中的工作者角色以進行追蹤
您必須以系統管理員身分登入,才能執行步驟 1 和 4。此步驟顯示編輯 Lambda 專案許可的範例。
如果您的專案是使用許可界限政策來佈建,則可以略過此步驟。
針對 2018 年 12 月 6 日之後建立的專案,AWS CodeStar 會使用許可界限政策來佈建您的專案。
-
登入AWS Management Console,然後打開 AWS CodeStar 控制台,請訪問https://console.aws.amazon.com/codestar/
。 -
建立專案或選擇使用
template.yml file
的現有專案,然後開啟 Project resources (專案資源) 頁面。 -
在專案資源,尋找資源清單中為 CodeStarWorker/Lambda 角色建立的 IAM 角色。該角色名稱遵循此格式:
role/CodeStarWorker-
。 選擇角色的 ARN。Project_name
-lambda-Function_name
-
在 IAM 主控台開啟該角色。選擇 Attach policies (連接政策)。搜尋
AWSXrayWriteOnlyAccess
政策,選取旁邊的方框,然後選擇 Attach Policy (連接政策)。
步驟 2:修改 template.yml 檔案以進行追蹤
-
開啟位於的 AWS CodeStar 主控台https://console.aws.amazon.com/codestar/
。 -
選擇您的無伺服器專案,然後開啟程式碼頁面。在儲存庫的最上層,尋找和編輯
template.yml
檔案。在Resources
下方將資源貼到Properties
部分。Tracing: Active
此範例顯示修改過的範本:
步驟 3:執行和推送您的範本變更以進行追蹤
-
遞交和推送
template.yml
檔案中的變更。注意 此會啟動您的管道。如果您在更新 IAM 許可之前遞交變更,您的管道開始執行,AWS CloudFormation 堆疊更新發生錯誤,堆疊更新會還原。如果發生這種情況,請修正權限,然後重新啟動您的管道。
步驟 4:監控AWS CloudFormation追蹤堆疊更新
-
當專案的管道啟動部署階段,AWS CloudFormation 堆疊更新便會啟動。若要在 AWS CodeStar 主控板查看堆疊更新狀態,請選擇AWS CloudFormation階段在您的管道。
如果在 AWS CloudFormation 中的堆疊更新傳回錯誤,請參閱AWS CloudFormation:遺失許可的回復建立堆疊中的故障診斷指南。如果工作者角色遺漏許可,請編輯連接到您專案的 Lambda 工作者角色的政策。請參閱 步驟 1:編輯 IAM 中的工作者角色以進行追蹤。
-
使用儀表板檢視成功完成的管道。您的應用程式現已啟用追蹤功能。
-
在 Lambda 主控台檢視您的函數詳細資訊,確認追蹤功能已啟用。
-
選擇專案的應用程式端點。與您應用程式的這項互動會被追蹤。您可以檢視 AWS X-Ray 主控台中的追蹤資訊。