.NET için Azure Load Testing istemci kitaplığı - sürüm 1.0.1

Makale
04/03/2023

Azure Load Testing, kullanıcıya Azure Load Testing hizmetiyle yerel olarak etkileşim kurabileceği .NET'te istemci kitaplığı sağlar. Azure Load Testing, yüksek ölçekli yük oluşturmanızı sağlayan tam olarak yönetilen bir yük testi hizmetidir. Hizmet, nerede barındırıldığına bakılmaksızın uygulamalarınız için trafiğin simülasyonunu oluşturur. Geliştiriciler, test ediciler ve kalite güvencesi (QA) mühendisleri bunu kullanarak uygulama performansını, ölçeklenebilirliğini veya kapasitesini iyileştirebilir.

Kaynak kodu | Paket (NuGet) | API başvuru belgeleri | Ürün belgeleri

Belgeler

Başlamanıza yardımcı olacak çeşitli belgeler mevcuttur

Başlarken

Paketi yükleme

NuGet ile .NET için istemci kitaplığını yükleyin:

dotnet add package Azure.Developer.LoadTesting

Önkoşullar

Azure aboneliğiniz ve Azure Load Test Hizmeti Kaynağınız olmalıdır. C# 8.0 söz diziminin avantajlarından yararlanmak için dil sürümüyle .NET Core SDK 3.0 veya üzerini latestkullanarak derlemeniz önerilir. Dil sürümünü previewkullanarak .NET Core SDK 2.1.x ile derlemek de mümkündür.

İstemcinin kimliğini doğrulama

Azure Active Directory (AAD) belirteci kimlik bilgilerini kullanmak için azure-identity kitaplığından elde edilen istenen kimlik bilgisi türünün bir örneğini sağlayın.

AAD ile kimlik doğrulaması yapmak için öncelikle nuget yüklemesini kullanmanız gerekir azure-identity

Kurulumdan sonra Azure.Identity'den hangi kimlik bilgisi türünü kullanacağınızı seçebilirsiniz.

Örneğin, Azure CLI az login komutuyla oturum açın; DefaultAzureCredential bu kullanıcı olarak kimlik doğrulaması yapar.

İstemcinin kimliğini doğrulamak için döndürülen belirteç kimlik bilgilerini kullanın.

Önemli kavramlar

Aşağıdaki bileşenler Azure Load Testing hizmetini oluşturur. C# için Azure Load Test istemci kitaplığı, istemcileri kullanarak bu bileşenlerin her biriyle etkileşim kurmanızı sağlar. İki istemci vardır:

LoadTestAdministrationClient
LoadTestRunClient

Bu istemciler, hizmetin farklı bileşenlerini yönetmek ve kullanmak için kullanılır. Bu alt istemcilerin her ikisindeki her yöntem için aynı sınıfta karşılık gelen bir Async yöntemi vardır ve aynı uygulama zaman uyumsuz işlevleri etkinleştirir. Örneğin, bir yöntemi varsa, CreateOrUpdateTest bir parçası LoadTestAdministrationClient olarak aynı istemci sınıfında her zaman bir işlev CreateOrUpdateTestAsync daha vardır.

Yük Testi Yönetim İstemcisi

İstemci LoadTestAdministrationClient yük testlerini, uygulama bileşenlerini ve ölçümleri yönetmek ve yapılandırmak için kullanılır.

Test etme

Test, test betiğini ve yük testi çalıştırmaya yönelik yapılandırma ayarlarını belirtir. Azure Load Testing kaynağında bir veya daha fazla test oluşturabilirsiniz.

Uygulama Bileşeni

Azure tarafından barındırılan bir uygulama için yük testi çalıştırdığınızda, farklı Azure uygulama bileşenleri (sunucu tarafı ölçümleri) için kaynak ölçümlerini izleyebilirsiniz. Yük testi çalışırken ve test tamamlandıktan sonra Azure Load Testing panosunda kaynak ölçümlerini izleyebilir ve analiz edebilirsiniz.

Ölçümler

Yük testi sırasında Azure Load Testing, test yürütmesi hakkındaki ölçümleri toplar. İki tür ölçüm vardır:

İstemci tarafı ölçümleri, test altyapısı tarafından bildirilen ayrıntıları sağlar. Bu ölçümler sanal kullanıcı sayısını, istek yanıt süresini, başarısız isteklerin sayısını veya saniyedeki istek sayısını içerir.
Sunucu tarafı ölçümleri, Azure tarafından barındırılan uygulamalar için kullanılabilir ve Azure uygulama bileşenleriniz hakkında bilgi sağlar. Ölçümler veritabanı okuma sayısı, HTTP yanıtlarının türü veya kapsayıcı kaynak tüketimi için olabilir.

Test Çalıştırma İstemcisi

İstemci LoadTestRunClient , yük testine karşılık gelen test çalıştırmalarını başlatmak ve durdurmak için kullanılır. Test çalıştırması, yük testinin bir yürütmesini temsil eder. Apache JMeter betiğini çalıştırmayla ilişkili günlükleri, yük testi YAML yapılandırmasını, izlenecek uygulama bileşenlerinin listesini ve testin sonuçlarını toplar.

Data-Plane Uç Noktası

Azure Load Testing kaynaklarının veri düzlemi şu URL biçimi kullanılarak adreslenebilir:

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

İlk GUID 00000000-0000-0000-0000-000000000000 , Azure Load Testing kaynağına erişmek için kullanılan benzersiz tanımlayıcıdır. Bunu kaynağın Azure bölgesi izler aaa .

Veri düzlemi uç noktası Denetim Düzlemi API'lerinden alınır.

Örnek:1234abcd-12ab-12ab-12ab-123456abcdef.eus.cnt-prod.loadtesting.azure.com

Yukarıdaki örnekte Azure eus bölgesini East UStemsil eder.

Örnekler

Örnekleri kullanarak farklı API'ler hakkında bilgi edinebilirsiniz.

Sorun giderme

Bu konuda daha fazla bilgi yakında...

İş parçacığı güvenliği

Tüm istemci örneği yöntemlerinin iş parçacığı açısından güvenli ve birbirinden bağımsız olduğunu garanti ediyoruz (kılavuz). Bu, istemci örneklerini yeniden kullanma önerisinin iş parçacıkları arasında bile her zaman güvenli olmasını sağlar.

Sonraki adımlar

Örneklerimizi kullanmaya başlayın.

Katkıda bulunma

Bu bir şablondur, ancak SDK benioku dosyasının depoya/pakete nasıl kod katkıda bulunabileceğinize ilişkin ayrıntıları içermesi gerekir.

Ek kavramlar