Клиентская библиотека нагрузочного тестирования Azure для .NET версии 1.0.1

Статья
04/03/2023

Нагрузочное тестирование Azure предоставляет пользователю клиентную библиотеку в .NET, с помощью которой он может взаимодействовать со службой нагрузочного тестирования Azure. Нагрузочное тестирование Azure — это полностью управляемая служба нагрузочного тестирования, которая позволяет создавать высокомасштабную нагрузку. Служба имитирует трафик для приложений, независимо от того, где они размещены. Разработчики, тестировщики и инженеры по контролю качества (QA) могут использовать его для оптимизации производительности, масштабируемости или емкости приложений.

Исходный код | Пакет (NuGet) | Справочная документация по | API Документация по продукту

Документация

Доступны различные документы, которые помогут вам приступить к работе

Начало работы

Установка пакета

Установите клиентную библиотеку для .NET с помощью NuGet:

dotnet add package Azure.Developer.LoadTesting

Предварительные требования

У вас должна быть подписка Azure и ресурс службы нагрузочных тестов Azure. Чтобы воспользоваться преимуществами синтаксиса C# 8.0, рекомендуется выполнить компиляцию с помощью пакета SDK для .NET Core 3.0 или более поздней версии с языковой версиейlatest. Также можно скомпилировать пакет SDK для .NET Core 2.1.x, используя языковую версию preview.

Аутентификация клиента

Чтобы использовать учетные данные маркера Azure Active Directory (AAD), укажите экземпляр нужного типа учетных данных, полученных из библиотеки azure-identity .

Для проверки подлинности с помощью AAD необходимо сначала использовать nuget install azure-identity

После настройки можно выбрать тип учетных данных из Azure.Identity для использования.

Например, войдите с помощью команды Azure CLI az login , и DefaultAzureCredential пройдет проверку подлинности от имени этого пользователя.

Используйте возвращенные учетные данные маркера для проверки подлинности клиента.

Основные понятия

Следующие компоненты составляют службу нагрузочного тестирования Azure. Клиентская библиотека нагрузочных тестов Azure для C# позволяет взаимодействовать с каждым из этих компонентов с помощью клиентов. Существует два клиента:

LoadTestAdministrationClient
LoadTestRunClient

Эти клиенты используются для управления различными компонентами службы и их использования. Для каждого метода в обоих этих вложенных клиентах имеется соответствующий Асинхронный метод в одном классе с той же реализацией, но с включением асинхронных функций. Например, если имеется метод, CreateOrUpdateTest то в том LoadTestAdministrationClient же классе клиента всегда существует еще одна функция CreateOrUpdateTestAsync .

Клиент администрирования нагрузочного теста

Клиент LoadTestAdministrationClient используется для администрирования и настройки нагрузочных тестов, компонентов приложения и метрик.

Тест

Тест указывает скрипт теста и параметры конфигурации для запуска нагрузочного теста. Вы можете создать один или несколько тестов в ресурсе нагрузочного тестирования Azure.

Компонент приложения

При запуске нагрузочного теста для приложения, размещенного в Azure, можно отслеживать метрики ресурсов для различных компонентов приложения Azure (метрики на стороне сервера). Во время выполнения нагрузочного теста и после его завершения вы можете отслеживать и анализировать метрики ресурсов на панели мониторинга нагрузочного тестирования Azure.

Метрики

Во время нагрузочного теста Azure Load Testing собирает метрики о выполнении теста. Есть два типа метрик:

Метрики на стороне клиента предоставляют сведения, сообщаемые подсистемой тестирования. Эти метрики включают число виртуальных пользователей, время отклика запроса, количество неудачных запросов или количество запросов в секунду.
Метрики на стороне сервера доступны для приложений, размещенных в 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 Load Testing. За ним следует aaa регион Azure ресурса.

Конечная точка плоскости данных получается из API уровня управления.

Пример: 1234abcd-12ab-12ab-12ab-123456abcdef.eus.cnt-prod.loadtesting.azure.com

В приведенном выше примере eus представляет регион East USAzure .

Примеры

Вы можете ознакомиться с различными API с помощью примеров.

Устранение неполадок

Подробнее об этом ожидается в ближайшее время ...

Потокобезопасность

Мы гарантируем, что все методы экземпляра клиента являются потокобезопасны и независимы друг от друга (руководство). Это гарантирует, что рекомендация по повторному использованию экземпляров клиента всегда будет безопасной, даже в разных потоках.

Дальнейшие действия

Начало работы с нашими примерами.

Участие

Это шаблон, но файл сведений пакета SDK должен содержать сведения о том, как внести код в репозиторий или пакет.

Дополнительные понятия