適用于 .NET 的 Azure 負載測試用戶端程式庫 - 1.0.1 版

發行項
04/03/2023

Azure 負載測試提供 .NET 中的用戶端程式庫給使用者，讓使用者可以透過此程式庫與 Azure 負載測試服務原生互動。 Azure 負載測試是完全受控的負載測試服務，可讓您產生大規模的負載。不論應用程式的裝載位置為何，服務都會模擬應用程式的流量。開發人員、測試人員和品質保證 (QA) 工程師可以使用它來優化應用程式效能、延展性或容量。

| 原始程式碼套件 (NuGet) | API 參考檔 | 產品檔

文件

有各種檔可協助您開始使用

開始使用

安裝套件

使用 NuGet安裝適用于 .NET 的用戶端程式庫：

dotnet add package Azure.Developer.LoadTesting

必要條件

您必須擁有 Azure 訂用帳戶和 Azure 負載測試服務資源。若要利用 C# 8.0 語法，建議您使用 .NET Core SDK 3.0 或更新版本與語言版本latest 進行編譯。您也可以使用語言版本的 preview .NET Core SDK 2.1.x 進行編譯。

驗證用戶端

若要使用 Azure Active Directory (AAD) 權杖認證，請提供從 azure-identity 程式庫取得所需認證類型的實例。

若要向 AAD 進行驗證，您必須先使用 nuget 安裝 azure-identity

設定之後，您可以從 Azure.Identity 選擇要使用的認證類型。

例如，透過 Azure CLI az login 命令登入，而 DefaultAzureCredential 會以該使用者身分驗證。

使用傳回的權杖認證來驗證用戶端。

重要概念

下列元件組成 Azure 負載測試服務。適用于 C# 的 Azure 負載測試用戶端程式庫可讓您透過用戶端使用來與每個元件互動。有兩個用戶端：

LoadTestAdministrationClient
LoadTestRunClient

這些用戶端用於管理及使用服務的不同元件。在這兩個子客戶端中的每個方法中，相同類別都有對應的 Async 方法，但啟用非同步功能的方式相同。例如，如果有方法，作為的 LoadTestAdministrationClient 一部分， CreateOrUpdateTest 則相同用戶端類別中一律會有一個以上的函 CreateOrUpdateTestAsync 式。

負載測試管理用戶端

用戶端 LoadTestAdministrationClient 用來管理和設定負載測試、應用程式元件和計量。

測試

測試會指定測試腳本和執行負載測試的組態設定。您可以在 Azure 負載測試資源中建立一或多個測試。

應用程式元件

當您針對 Azure 裝載的應用程式執行負載測試時，您可以監視不同 Azure 應用程式元件的資源計量 (伺服器端計量)。當負載測試執行時，以及測試完成後，您可以在 Azure 負載測試儀表板中監視和分析資源計量。

計量

在負載測試期間，Azure 負載測試會收集有關測試執行的計量。計量的類型有兩種：

用戶端計量可提供測試引擎所報告的詳細資料。這些計量包括虛擬使用者數目、要求回應時間、失敗要求數目或每秒要求數目。
伺服器端計量適用於 Azure 裝載的應用程式，並提供 Azure 應用程式元件的相關資訊。計量可以用於資料庫讀取數目、HTTP 回應的類型或容器資源耗用量。

測試回合用戶端

用戶端 LoadTestRunClient 用來啟動和停止對應至負載測試的測試回合。測試回合代表負載測試的一個執行。其會收集與執行 Apache JMeter 指令碼、負載測試 YAML 組態、要監視的應用程式元件清單，以及測試結果相關聯的記錄。

Data-Plane端點

Azure 負載測試資源的資料平面可以使用下列 URL 格式定址：

00000000-0000-0000-0000-000000000000.aaa.cnt-prod.loadtesting.azure.com

第一個 GUID 00000000-0000-0000-0000-000000000000 是用來存取 Azure 負載測試資源的唯一識別碼。後面接著 aaa 是資源的 Azure 區域。

資料平面端點是從控制平面 API 取得。

範例：1234abcd-12ab-12ab-12ab-123456abcdef.eus.cnt-prod.loadtesting.azure.com

在上述範例中， eus 代表 Azure 區域 East US 。

範例

您可以使用範例熟悉不同的 API。

疑難排解

即將推出...

執行緒安全

我們保證所有用戶端實例方法都是安全線程，且彼此獨立 (指導方針) 。這可確保重複使用用戶端實例的建議一律是安全的，即使是跨執行緒也一樣。

後續步驟

開始使用我們的範例。

參與

這是範本，但您的 SDK 讀我檔案應該包含如何將程式碼提供給存放庫/套件的詳細資料。

其他概念

共用方式為