Azure.Developer.LoadTesting 1.0.1

前缀已保留
dotnet add package Azure.Developer.LoadTesting --version 1.0.1                
NuGet\Install-Package Azure.Developer.LoadTesting -Version 1.0.1                
此命令意在 Visual Studio 的包管理器控制台中使用,因为它使用 NuGet 模块的 Install-Package 版本。
<PackageReference Include="Azure.Developer.LoadTesting" Version="1.0.1" />                
对于支持 PackageReference 的项目,将此 XML 节点复制到项目文件中以参考该包。
paket add Azure.Developer.LoadTesting --version 1.0.1                
#r "nuget: Azure.Developer.LoadTesting, 1.0.1"                
#r 指令可用于 F# Interactive 和多语言笔记本。将其复制到交互式工具或脚本的源代码中以参考该包。
// Install Azure.Developer.LoadTesting as a Cake Addin
#addin nuget:?package=Azure.Developer.LoadTesting&version=1.0.1

// Install Azure.Developer.LoadTesting as a Cake Tool
#tool nuget:?package=Azure.Developer.LoadTesting&version=1.0.1                

Azure Load Testing 的 .NET 客户端库

Azure Load Testing 通过提供 .NET 客户端库供用户使用,用户可以与 Azure Load Testing 服务进行原生交互。Azure Load Testing 是一项完全托管的负载测试服务,可以让你生成高规模负载。该服务模拟你应用程序的流量,无论它们托管在何处。开发者、测试人员和质量保证(QA)工程师可以使用它来优化应用程序的性能、可扩展性或容量。

源代码 | 包(NuGet) | API 参考 | 产品文档

文档

有各种文档可以帮助你开始使用

开始使用

安装包

使用 NuGet 安装 .NET 客户端库

dotnet add package Azure.Developer.LoadTesting

先决条件

您必须拥有一个 Azure 订阅Azure Load Test 服务资源。为了利用 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 Load Testing 服务。Azure Load Test 的 C# 客户端库允许您通过使用客户端与每个组件进行交互。有两个客户端

  • LoadTestAdministrationClient

  • LoadTestRunClient

这些客户端用于管理和使用服务不同的组件。对于这两个子客户端中的每个方法,在同一类中存在一个相应的 Async 方法,具有相同的实现但支持异步功能。例如,如果有 CreateOrUpdateTest 方法作为 LoadTestAdministrationClient 的一部分,则在该客户端类中始终存在另一个函数 CreateOrUpdateTestAsync

负载测试管理客户端

LoadTestAdministrationClient 客户端用于管理和配置负载测试、应用程序组件和指标。

测试

一个测试指定了测试脚本以及运行负载测试的配置设置。您可以在 Azure Load Testing 资源中创建一个或多个测试。

应用程序组件

当您对 Azure 托管的应用程序进行负载测试时,您可以监控不同 Azure 应用程序组件(服务器端指标)的资源指标。在负载测试运行期间以及测试完成后,您可以在 Azure Load Testing 仪表板中监控和分析资源指标。

指标

在负载测试期间,Azure Load Testing 会收集有关测试执行的指标。有两种类型的指标

  1. 客户端指标提供了测试引擎报告的详细信息。这些指标包括虚拟用户数量、请求响应时间、失败请求数量或每秒请求数量。

  2. 服务器端指标可用于 Azure 托管的应用程序,并提供有关您的 Azure 应用程序组件的信息。指标可以包括数据库读取次数、HTTP 响应类型或容器资源消耗。

测试运行客户端

LoadTestRunClient 客户端用于启动和停止与负载测试对应的测试运行。测试运行代表一次负载测试的执行。它收集与运行 Apache JMeter 脚本相关的日志、负载测试 YAML 配置、要监控的应用程序组件列表以及测试结果。

数据平面端点

可以使用以下 URL 格式访问 Azure Load Testing 资源的数据平面:<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区域 东美

示例

您可以通过示例熟悉不同的API。

故障排除

更多内容即将推出...

线程安全

我们保证所有客户端实例方法都是线程安全的,且相互独立(《指南》)。这确保了重用客户端实例的建议即使在多线程环境下也是安全的。

接下来做什么

从我们的示例开始。

贡献

这是一个模板,但您的SDK-readme应该包括关于如何向repo/package贡献代码的详细信息。

其他概念

客户端选项 | 访问响应 | 长运行操作 | 处理失败 | 诊断 | Mocking | 客户端寿命

产品 兼容和额外计算的目标框架版本。
.NET net5.0 已计算。 net5.0-windows 已计算。 net6.0 已计算。 net6.0-android 已计算。 net6.0-ios 已计算。 net6.0-maccatalyst 已计算。 net6.0-macos 已计算。 net6.0-tvos 已计算。 net6.0-windows 已计算。 net7.0 已计算。 net7.0-android 已计算。 net7.0-ios 已计算。 net7.0-maccatalyst 已计算。 net7.0-macos 已计算。 net7.0-tvos 已计算。 net7.0-windows 已计算。 net8.0 已计算。 net8.0-android 已计算。 net8.0-browser 已计算。 net8.0-ios 已计算。 net8.0-maccatalyst 已计算。 net8.0-macos 已计算。 net8.0-tvos 已计算。 net8.0-windows 已计算。
.NET Core netcoreapp2.0 已计算。 netcoreapp2.1 已计算。 netcoreapp2.2 已计算。 netcoreapp3.0 已计算。 netcoreapp3.1 已计算。
.NET Standard netstandard2.0 兼容。 netstandard2.1 已计算。
.NET Framework net461 已计算。 net462 已计算。 net463 已计算。 net47 已计算。 net471 已计算。 net472 已计算。 net48 已计算。 net481 已计算。
MonoAndroid monoandroid 已计算。
MonoMac monomac 已计算。
MonoTouch monotouch 已计算。
Tizen tizen40 已计算。 tizen60 已计算。
Xamarin.iOS xamarinios 已计算。
Xamarin.Mac xamarinmac 已计算。
Xamarin.TVOS xamarintvos 已计算。
Xamarin.WatchOS xamarinwatchos 已计算。
兼容的目标框架
包中包含的目标框架
了解更多关于 目标框架.NET 标准化 的信息。

NuGet 包

此包未被任何 NuGet 包使用。

GitHub 仓库

此包未被任何流行的 GitHub 仓库使用。

版本 下载 最后更新
1.0.1 35,161 3/13/2023
1.0.0 218 3/7/2023
1.0.0-beta.2 459 1/21/2023
1.0.0-beta.1 285 10/25/2022