— инструмент для автоматического создания документация. Он создает документацию путем анализа интерфейсов и комментариев в исходном коде и поддерживает различные форматы вывода документов, включая , другие. Целью разработки smart-doc является упрощение процесса написания документов, повышение эффективности разработки, а также обеспечение точности и своевременности документации. smart-doc Java API Markdown HTML5 , OpenAPI 3.0 и В жизненном цикле разработки программного обеспечения автоматическое создание документации API и тестирование производительности интерфейсов являются ключевыми шагами в повышении эффективности разработки и обеспечении качества продукта. С добавлением возможности генерировать JMeter скриптов в версии разработчикам будет удобнее выполнять эти две задачи. тестирование производительности smart-doc 3.0.1 В этой статье рассказывается, как использовать smart-doc и JMeter для эффективного тестирования производительности. JMeter Создание сценариев Использование для создания Сценарии тестирования производительности могут значительно сократить время, затрачиваемое на написание сценариев тестирования производительности, тем самым повышая эффективность тестирования. Скрипты JMeter, автоматически генерируемые с помощью можно запускать непосредственно в JMeter без необходимости сложной настройки и отладки, что значительно упрощает и ускоряет тестирование производительности. smart-doc JMeter smart-doc Сначала убедитесь, что добавлен в ваш проект. Затем настройте соответствующие параметры плагина smart-doc в файле проекта, например: smart-doc-maven-plugin pom.xml <plugin> <groupId>com.ly.smart-doc</groupId> <artifactId>smart-doc-maven-plugin</artifactId> <version>[latest version]</version> <configuration> <configFile>./src/main/resources/smart-doc.json</configFile> <projectName>${project.description}</projectName> </configuration> </plugin> Запустите команду . Smart-doc просканирует исходный код проекта, извлечет информацию аннотаций и автоматически сгенерирует соответствующие сценарии тестирования производительности JMeter. mvn -Dfile.encoding=UTF-8 smart-doc:jmeter Те, кто не знаком с тем, как им пользоваться, могут обратиться к официальному . документация смарт-док Импортировать в JMeter Откройте JMeter, нажмите « » -> « », выберите файл сценария JMeter, созданный на первом этапе, и нажмите кнопку « ». Затем JMeter начнет выполнять тесты производительности в соответствии со сценарием. Файл Открыть Пуск Настроить Прометей — это инструмент мониторинга и оповещения с открытым исходным кодом для обработки данных временных рядов. Мы можем использовать его для мониторинга в реальном времени во время процесса стресс-тестирования JMeter, тем самым повышая наблюдаемость тестирования производительности. Прометей Шаг 1. Установите плагин JMeter Prometheus. Во-первых, вам нужно установить плагин Prometheus в каталог JMeter. Вы можете загрузить плагин из менеджера плагинов JMeter или . Его также можно скачать с . В этом случае загрузите последнюю версию 0.7.1 с GitHub. lib/ext Официальный веб-сайт GitHub IP-адрес прослушивания JMeter по умолчанию — , что по умолчанию не позволяет Prometheus подключаться к порту прослушивания JMeter Prometheus. Поэтому необходимо добавить в . Примечание. 127.0.0.1 prometheus.ip=0.0.0.0 jmeter.properties Шаг 2. Добавьте прослушиватель Prometheus Откройте JMeter и добавьте прослушиватель Prometheus в свой план тестирования. Это можно сделать, щелкнув правой кнопкой мыши -> -> -> . Test Plan Add Listener Prometheus Listener Конфигурацию прослушивателя можно найти в официальных настройках со следующей ссылкой ( поддерживает настройку и добавление генерации прослушивателя Prometheus): smart-doc 3.0.4 Шаг 3. Настройте очистку Prometheus В файле конфигурации Prometheus ( ) добавьте новый для получения данных из плагина JMeter Prometheus. Например: prometheus.yml scrape_config scrape_configs: - job_name: 'jmeter' scrape_interval: 15s static_configs: - targets: ['<Your JMeter machine IP>:9270'] Здесь — это IP-адрес компьютера, на котором выполняется тест JMeter, а — это порт прослушивания по умолчанию для плагина JMeter Prometheus. <Your JMeter machine IP> 9270 Шаг 4. Запустите план тестирования Для облегчения проверки в этой статье во время стресс-тестирования для группы потоков задан режим « », который можно настроить в соответствии с фактическими потребностями. бесконечный цикл После успешного запуска JMeter Prometheus по умолчанию создаст службу на локальном порту . 9270 Доступ к URL-адресу и если вы увидите следующее содержимое, это означает, что оно прошло успешно. , http://localhost:9270/метрики Шаг 5: Запустите Прометей После запуска он начнет получать данные из плагина JMeter Prometheus. Как показано в следующей конфигурации, после успешного запуска вы сможете увидеть установленные цели в . Prometheus Prometheus Шаг 6: Настройте Графану На официальном сайте найдите панель мониторинга prometheus-jmeter, предоставленную официальным сайтом. Здесь мы выбираем шаблон с идентификатором для импорта в Grafana. Grafana 14927 После нажатия кнопки выберите источник данных . «Загрузить» Prometheus В ходе тестирования было обнаружено, что исходный шаблон содержит некоторые ошибки. Они были исправлены в процессе написания статьи. Импортируйте исправленный шаблон, скачанный с . Примечание. 14927 GitHub После успешного импорта шаблона мы сможем увидеть все данные мониторинга тестирования производительности в . Grafana Чтобы облегчить быстрый процесс всего процесса тестирования производительности, сообщество разработало и предоставило шаблон, который можно запустить с помощью одной команды с помощью . Те, кто хочет испытать это при развертывании , могут использовать инструменты искусственного интеллекта для прямого преобразования шаблона в шаблон развертывания . smart-doc docker-compose Kubernetes docker-compose Kubernetes Проект для опыта также включает инструкции по использованию. Пример кода для этой статьи можно найти . здесь Помощь Smart-Doc в тестировании производительности JMeter Комбинация и JMeter для нагрузочного тестирования производительности дает несколько преимуществ: smart-doc может автоматически извлекать информацию API из исходного кода и генерировать сценарии тестирования производительности JMeter без необходимости написания вручную, что значительно повышает эффективность. Автоматизация: smart-doc сценарии тестирования производительности JMeter, созданные с помощью полностью соответствуют определениям API в исходном коде, что позволяет избежать ошибок, которые могут возникнуть при написании сценариев вручную. Точность: smart-doc поддерживает множество вариантов конфигурации, позволяя настраивать сгенерированные сценарии JMeter в соответствии с требованиями тестирования. Гибкость: smart-doc также продолжит улучшать и оптимизировать поддержку JMeter. Пожалуйста, следите за обновлениями . smart-doc продолжающееся развитие проекта с открытым исходным кодом smart-doc Заключение Объединив и JMeter, мы можем не только автоматизировать создание документации API, но также быстро создавать сценарии тестирования производительности и проводить стресс-тестирование. Этот инструмент автоматизации значительно повышает эффективность разработки и тестирования, помогая командам легче поддерживать и оптимизировать производительность программных систем. smart-doc Мы надеемся, что эта статья предоставила вам практические рекомендации, которые помогут вам более эффективно применять эти инструменты в повседневной работе. Мы также приглашаем всех продолжать следить за сообществом смарт-документов с открытым исходным кодом и поддерживать его. В будущем мы изучаем возможность поддержки дополнительных языков, чтобы помочь большему числу разработчиков.