Ваш первый тест производительности в Postman: Краткое руководство

Фото: Ethan Hoover (Unsplash) — https://unsplash.com/photos/close-view-of-two-gray-us-mailboxes-wu_po9Tx16A?utm_source=dev48&utm_medium=referral

Источник: Postman Blog•

Ваш первый тест производительности в Postman: Краткое руководство

Запустите свой первый тест производительности в Postman, повторно используя существующую коллекцию. Настройте виртуальных пользователей, пороговые значения и интеграцию с CI с помощью Postman CLI. Попробуйте прямо сейчас. Статья Your First Performance Test in Postman: A Quick Guide опубликована…

2 ноября 2026 г.

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

Вам не обязательно это делать. Ваш первый тест производительности в Postman использует уже имеющуюся у вас коллекцию. К концу этой статьи она будет запускаться на облачных агентах Postman с пороговым значением успешного/неуспешного выполнения (pass/fail), которое может блокировать вашу задачу CI. Вы также сможете передать этот же тест агенту написания кода с помощью одной подсказки.

Что нужно для первого теста производительности?

Выберите реальный рабочий процесс. Установите количество виртуальных пользователей и продолжительность. Добавьте пороговые значения успешного/неуспешного выполнения для 95-го перцентиля (p95) задержки и частоты ошибок. Затем запустите тест оттуда, откуда фактически должна исходить нагрузка. Используйте облачные агенты, если вам нужен объем, или запустите локально, если вы просто хотите сделать быструю проверку.

Допустим, у вас есть коллекция для оформления заказа, которая уже успешно проходит функциональные тесты. Ваш первый тест производительности в Postman использует ту же самую коллекцию. Каждый виртуальный пользователь выполняет выбранные запросы по порядку в повторяющемся цикле в течение заданного вами времени.

Как запустить ваш первый тест производительности в Postman?

  • Выберите коллекцию, которая уже успешно проходит функциональные тесты.
  • Откройте Postman, выберите коллекцию и нажмите «Запустить» (Run).
  • В поле «Тип запуска» (Run type) выберите «Производительность» (Performance).
  • Установите количество виртуальных пользователей, продолжительность и профиль нагрузки.
  • Добавьте пороговое значение успешного/неуспешного выполнения, например для p95 задержки.
  • Выберите «Облако» (Cloud) в качестве агента и нажмите «Запустить в облаке» (Run on Cloud). Вместо этого выберите «Локально» (Local) для быстрой проверки на вашем собственном компьютере.
  • Наблюдайте за временной шкалой в реальном времени по мере увеличения числа виртуальных пользователей. По окончании запуска откройте его в Postman, чтобы увидеть, где возросла задержка и какие запросы замедлились в первую очередь.

Как запустить тест с помощью Postman CLI?

Postman CLI — это инструмент, с помощью которого тестирование производительности перестает быть разовой задачей и превращается в процесс, который можно встроить в CI.

Войдите в систему один раз:

Затем запустите тест производительности для коллекции по ее ID:

Добавьте пороговое значение успешного/неуспешного выполнения, чтобы команда возвращала ненулевой код выхода при превышении задержки или ошибок:

Если p95 задержки остается ниже порогового значения, команда возвращает код 0. Если нет, команда возвращает ненулевой код, и ваша задача CI завершается с ошибкой. Дополнительную информацию о каждом параметре см. в документации Postman CLI performance testing docs.

Откуда должна исходить нагрузка?

Нагрузка исходит с машины, которая инициирует запуск, или из облачных агентов Postman, если вы добавите --runner postman-cloud к той же команде.

Когда следует запускать тесты локально?

Запускайте тесты локально в процессе их создания. Локальный запуск создает нагрузку с машины, которая его инициирует (вашего ноутбука или агента CI), при этом локальное тестирование производительности не ограничено на любом тарифном плане. Используйте его для проверки порядка запросов, тестовых скриптов и пороговых значений при небольшой нагрузке. Следите за состоянием вашего компьютера, так как перегруженная машина искажает результаты. Переходите на облачные агенты Postman, когда вам требуется нагрузка, превышающая возможности одного компьютера.

Когда следует запускать тесты в Postman Cloud?

Добавление --runner postman-cloud к той же команде распределяет нагрузку между несколькими машинами. Вы получаете больше параллельных запросов, чем может выдать один ноутбук или агент CI, и вам не нужно обслуживать серверы генератора нагрузки. Облачные запуски продолжаются, даже если вы закроете свой компьютер, а метрики, утверждения, ошибки и системные метрики сохраняются в Postman для последующего анализа и сравнения.

Команда возвращает результат --pass-if в качестве кода выхода, поэтому установите тайм-аут задачи CI по меньшей мере равным продолжительности теста. 30-минутный запуск с тайм-аутом задачи в 10 минут — это просто нестабильный тест.

Если тестируемый вами API находится за списком разрешенных IP-адресов (allowlist), используйте --runner postman-cloud-static-ip. Это предоставит вам фиксированные IP-адреса в регионе вашего аккаунта (США или ЕС для режима EU Data Residency), которые вы можете внести в белый список на целевом сервере. Полное пошаговое руководство см. в материале о тестировании нагрузки API за брандмауэром.

Еще несколько полезных фактов:

  • Результаты записываются в рабочую область Postman, поэтому любой пользователь, имеющий доступ, может открыть запуск и посмотреть, что произошло.
  • При облачных запусках параметр --data-file превращается в набор данных, загружаемый в Postman, а конфиденциальные данные перемещаются в секреты Shared Vault вместо локальной переменной окружения.
  • Коллекции настройки (setup) и завершения (teardown) требуют использования параметра --runner postman-cloud.
  • Облачные запуски и статические IP-адреса доступны на платных тарифах.

Может ли агент написания кода сделать это за меня?

Да. Плагин Postman переносит возможности Postman в Claude Code, Codex, Cursor, OpenCode, Pi и другие агенты написания кода, а также выполняет задачи через Postman CLI.

Установите его одним из следующих способов:

Для этого требуется Node.js версии 22 или выше.

Для Claude Code:

Для Cursor:

Навык тестирования производительности (performance-testing skill) выполняет нагрузочное тестирование коллекции с виртуальными пользователями, профилем нагрузки и пороговыми значениями успешного/неуспешного выполнения локально или на облачных агентах Postman.

Промпт, который я действительно использую:

Агент преобразует его в команду запуска производительности postman с параметром --runner postman-cloud и порогом --pass-if, выполняет ее через Postman CLI и сообщает результат. Запуск записывается в Postman для рабочего пространства.

Как узнать, что это действительно сработало?

Код выхода — это первый сигнал. Нуль означает, что ваши пороговые значения были соблюдены. Ненулевое значение означает обратное.

Откройте записанный запуск в Postman, чтобы изучить временную шкалу. Посмотрите, в какой момент p95 пошел вверх, концентрировались ли ошибки при определенном количестве виртуальных пользователей и какие запросы замедлились в первую очередь.

Каковы реальные ограничения?

Несколько моментов, о которых стоит сказать прямо. Облачные запуски работают из веб-приложения Postman и десктопного приложения. Локальным запускам требуется десктопное приложение или Postman CLI, так как нагрузка исходит с вашего собственного компьютера. Каждый виртуальный пользователь выполняет выбранные запросы по порядку в повторяющемся цикле, поэтому, если вам требуется сложное ветвление поведения пользователей, вам нужно будет разделить его на отдельные коллекции. Облачные запуски и статические IP-адреса доступны на платных тарифах.

Часто задаваемые вопросы

Могу ли я использовать свои коллекции функциональных тестов для нагрузочного тестирования?

Ваши коллекции функциональных тестов могут запускаться как тесты производительности без переписывания. Каждый виртуальный пользователь выполняет выбранные запросы по порядку в повторяющемся цикле, а пороговые значения успешного/неуспешного выполнения определяют результат. Начните локально, а затем используйте облачные агенты Postman, когда вам потребуется нагрузка, превышающая возможности одного компьютера.

Как встроить это в CI?

Добавьте шаг запуска производительности postman с параметром --runner postman-cloud, количеством виртуальных пользователей --vu-count, продолжительностью --duration и выражением --pass-if. Установите тайм-аут задачи по меньшей мере равным продолжительности теста. Код выхода управляет конвейером, а запуск записывается в Postman для рабочей области.

Нужен ли мне платный тариф?

Локальное тестирование производительности не ограничено на любом тарифном плане, включая Бесплатный. Облачные запуски и статические IP-адреса доступны на платных тарифах, а облачные запуски тарифицируются по цене 0,04 доллара США за час работы виртуального пользователя. 30-минутный запуск со 100 виртуальными пользователями расходует 50 часов работы виртуальных пользователей, то есть 2 доллара США. Подробные сведения о текущих тарифах см. на странице Postman pricing.

Могу ли я повторно использовать свои окружения и файлы данных при облачном запуске?

Та же коллекция, которую вы используете для функциональных запусков, работает и для тестов производительности. При облачных запусках --data-file превращается в набор данных, загружаемый в Postman, а любые секретные данные следует перенести из переменных окружения в секреты Shared Vault, чтобы они не хранились в локальном файле.

С какого количества виртуальных пользователей мне следует начать?

Начните с небольшого числа виртуальных пользователей и малой длительности, а затем откалибруйте свои пороговые значения на основе успешного запуска. Узнав, как выглядит нормальная работа, увеличьте нагрузку. Когда вашей машине перестанет хватать ресурсов, добавьте в ту же команду флаг --runner postman-cloud.

Попробуйте

Полное руководство по конфигурации приведено в документации по настройке тестов производительности, а параметры установки агента — в обзоре плагина Postman.

Попробуйте Postman прямо сейчас.

Ресурсы

  • Конфигурация теста производительности: полное руководство по виртуальным пользователям, профилям нагрузки, пороговым значениям --pass-if и флагам облачного исполнителя.
  • Тестирование производительности с помощью Postman CLI: все параметры для postman performance run, включая исполнителей и пороговые значения.
  • Обзор плагина Postman: параметры установки для Claude Code, Codex, Cursor, OpenCode и Pi, а также возможности, которые предоставляет плагин.
  • Обзор Postman CLI: установка, аутентификация и запуск коллекций из любой CI-системы.
  • Как провести нагрузочное тестирование API за брандмауэром: использование статических IP-адресов, чтобы ваш API из белого списка принимал облачную нагрузку.
  • Может ли Postman выполнять нагрузочное тестирование? Да, вот как это работает: предыстория о том, почему повторное использование функциональных коллекций для нагрузочных тестов исключает необходимость создания второго набора.

О чём эта статья