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

# AWS DevOps 代理程式整合
<a name="devops-agent-integration"></a>

使用 [AWS DevOps 代理](https://aws.amazon.com/devops-agent/)程式，您可以直接從 AWS 解決方案上的分散式負載測試自動調查負載測試結果。當您連接 代理程式空間時，您可以將完成的測試執行傳送至代理程式進行分析。代理程式會主動識別效能瓶頸、判斷根本原因，並建議修復步驟，而不需要手動關聯 Amazon CloudWatch 指標、日誌和追蹤。

## 先決條件
<a name="devops-agent-prerequisites"></a>

在將 代理程式空間連線至 AWS (DLT) 上的分散式負載測試之前，請先完成下列操作：
+ 代理程式空間必須與 DLT 部署位於相同的 AWS 帳戶中。
+ 代理程式空間必須以索引鍵 `dlt-integration`和值 標記`allowed`。此標籤會建立雙重同意，DLT 運算子和 Agent Space 管理員都必須採取明確動作，DLT 才能存取 Agent Space。
+ `dlt-integration: allowed` 標籤必須存在，DLT 才能接受測試連線或調查請求，即使客服人員空間 ARN 有效。

若要新增標籤，請選擇 [AWS DevOps 代理程式主控台](https://console.aws.amazon.com/aidevops)，然後選擇您的代理程式空間。選擇 **Configuration** (組態) 索引標籤。向下捲動至**標籤**區段，選擇**新增標籤**，輸入 `dlt-integration`做為索引鍵，輸入 `allowed` 做為值，然後選擇**儲存**。

## 註冊 代理程式空間
<a name="devops-agent-register"></a>

標記您的 Agent Space 之後，請完成下列步驟以向 DLT 註冊它：

1. 在 DLT Web 主控台左側邊欄中選擇**客服人員整合**。

1. 在 **DevOps 代理程式連線**區段中，選擇**註冊代理程式空間**。

1. 輸入顯示名稱，並從 AWS DevOps Agent 主控台貼上 Agent Space ARN。

1. 選擇**測試連線**來驗證 ARN 是否可連線，以及`dlt-integration: allowed`標籤是否存在。

1. 確認連線後，選擇**儲存**。

您可以註冊多個客服人員空間，並在觸發調查時在它們之間選取。

## 調查測試執行
<a name="devops-agent-investigate"></a>

註冊至少一個客服人員空間後，您可以從任何已完成的測試執行開始調查。**使用 DevOps 代理程式調查**按鈕會出現在每個測試執行詳細資訊頁面上。請完成下列步驟：

1. 在測試執行完成後，選擇**使用 DevOps 代理程式調查** - 成功、失敗或部分。

1. 如果您註冊了多個客服人員空間，請從清單中選擇一個。

1. 或者，提供其他內容，例如最近基礎設施變更的說明或預期的效能基準。

1. 選擇**提交**。

調查會出現在測試執行詳細資訊頁面的**調查**索引標籤中，您可以在其中追蹤其狀態，然後選擇連結以在 AWS DevOps 代理程式主控台中檢視問題清單。

**注意**  
AWS DevOps 代理程式會對調查描述強制執行 10，000 個字元的限制。解決方案傳送的描述結合了您的選用內容與 DLT 產生的測試執行摘要 （測試組態、基準比較、依計數排序的熱門錯誤，以及每個端點明細）。為了符合限制，解決方案會優先考慮測試組態和使用者提供的內容，並在合併長度超過 10，000 個字元時修剪優先順序較低的區段，從每個端點的明細開始。

## 檢閱調查結果
<a name="devops-agent-findings"></a>

AWS DevOps 代理程式調查通常在幾分鐘內完成，但可能會因代理程式空間組態而有所不同。完成後，選擇**調查**索引標籤中的**檢視問題清單**，以在 AWS DevOps 代理程式主控台中開啟問題清單。

調查結果包括下列項目：
+ 結構化根本原因分析，可識別哪些元件導致延遲或錯誤。
+ 在測試時段期間觀察到的症狀清單。
+ 具體的修補建議。

在測試執行記錄的生命週期內，調查會保留在 DLT **調查**索引標籤中，因此您可以隨著應用程式的演進而參考先前的分析。

## 建議的工作流程
<a name="devops-agent-suggested-workflow"></a>

若要充分利用 AWS DevOps Agent 整合，請將其用作反覆效能調校迴圈的一部分：部署、負載測試、調查、修復和重複。每個通過迴圈都會為客服人員提供更多歷史記錄，以便與 進行比較，並為您提供可衡量的證據，證明變更改善了效能。

1.  **部署**：將您的應用程式部署到您想要測試的環境，並完成[先決條件](#devops-agent-prerequisites)和[註冊客服人員空間中所述的](#devops-agent-register)一次性設定。

1.  **建立基準** — 針對已知良好的組建執行您的測試案例，並將執行指定為基準 （請參閱[基準比較](explore-test-results.md#baseline-comparison))。設定基準時，解決方案會包含與調查請求的比較，因此客服人員可以區分迴歸與正常變化。

1.  **負載測試** — 在每次應用程式或基礎設施變更後執行測試案例。在執行之間保持案例組態不變，以便結果保持可比較性。

1.  **調查** — 執行完成後，在測試執行詳細資訊頁面上選擇**使用 DevOps 代理程式進行調查**。提供自上次執行以來變更的內容 — 最近的部署、組態變更或您預期的效能 — 以便代理程式可以專注於其分析。

1.  **修復** — 在**調查**索引標籤中檢閱根本原因和修復建議，或在 AWS DevOps 代理程式主控台中開啟問題清單以產生緩解計畫。將修正套用至您的應用程式或基礎設施。

1.  **重複** — 重新執行測試案例，並將結果與您的基準進行比較，以驗證修正。當效能改善時，請指定新的執行做為您的基準，並繼續執行下一個變更。

**注意**  
每個測試執行一次支援一個主動調查。在相同測試執行中啟動新的調查之前，請先從**調查**索引標籤封存已完成的調查。