Allure Report: понятные отчёты по автотестам — шаги, скриншоты и история прогонов
Allure Report — открытый инструмент, который превращает результаты автотестов в HTML-отчёт: дерево тестов по функциям продукта, шаги каждого сценария, скриншоты, ответы API и логи, статусы и историю прогонов. Сами тесты он не запускает. Адаптер для pytest, JUnit 5, Playwright или другого фреймворка во время прогона пишет файлы в папку allure-results, а командная строка Allure собирает из них отчёт. Чтобы отчёт приносил пользу, нужно подключить адаптер, разметить шаги и вложения, расставить метки и сохранять историю между запусками в CI.
Содержание

Новички часто думают, что после установки плагина отчёт станет понятным сам. Без разметки Allure покажет тот же список зелёных и красных тестов, что и консоль. Ценность появляется, когда тест описан шагами («добавить товар», «применить промокод», «проверить сумму»), к упавшему шагу приложен скриншот, а метки раскладывают тесты по разделам продукта. Тогда разработчик видит, где сломалось, не запуская тест у себя.
Кому и зачем нужен Allure
Автоматизатор разбирает по отчёту падения ночного прогона и отделяет дефекты продукта от сломанных тестов. Разработчик смотрит, какой шаг упал и что вернул сервер. Ведущий тестировщик проверяет, какие функции покрыты и стабилен ли набор от сборки к сборке.
Для такого разбора в Allure есть статусы с разным смыслом. По описанию статусов в документации failed (красный) означает, что проверка выполнилась и не прошла, — вероятен дефект продукта. Broken (жёлтый) — тест упал по собственной причине: например, не прочитал файл конфигурации или получил исключение вне проверки. Граница между ними в разных адаптерах проводится по-разному, но привычка начинать разбор с красных, а жёлтые отдавать на починку тестов экономит время.
Если тестов два десятка и их запускает один человек, хватит вывода pytest в консоли. А для хранения ручных тест-кейсов и планирования регресса нужна система управления тестированием, а не генератор отчётов.
Как устроен отчёт: адаптер, файлы и генерация
Работа идёт в две фазы. Сначала тесты запускаются с адаптером: для Python это пакет allure-pytest и команда python -m pytest --alluredir allure-results. В руководстве по pytest отмечено, что если папка уже существует, новые файлы добавляются к старым. Затем allure generate собирает HTML-отчёт, allure open открывает его, а allure serve делает и то и другое за один раз.
В Java-проектах на JUnit 5 есть две тонкости. По документации интеграции с JUnit 5 артефакт теперь называется allure-jupiter: он заменил allure-junit5 в версии Allure Java 2.35.1, а с версии 3.0 старое имя больше не публикуется, поэтому в старых инструкциях зависимость устарела. Вторая — аннотации @Step и @Attachment работают через AspectJ: без агента aspectjweaver в тестовой JVM тесты проходят, но шагов в отчёте нет.
Сейчас существуют две ветки. Allure 3 ставится через npm и требует Node.js, читает конфигурацию из файла allurerc.mjs и добавил команду allure run, которая с флагом --rerun перезапускает упавшие тесты. По руководству по переходу на Allure 3 адаптеры менять не нужно: они пишут те же файлы результатов, что и для Allure 2.
Учебный пример: тест промокода с шагами и вложениями
Ситуация учебная. Тестировщица проверяет, что промокод SALE10 снижает сумму корзины с 1000 до 900 рублей; фикстуры api и page подготовлены заранее.
import allure
@allure.epic("Интернет-магазин")
@allure.feature("Корзина")
@allure.severity("critical")
def test_promo_code(api, page):
with allure.step("Добавить товар в корзину через API"):
cart = api.add_to_cart(item_id=42)
allure.attach(cart.text, name="Ответ API",
attachment_type=allure.attachment_type.JSON)
with allure.step("Применить промокод SALE10"):
page.goto("/cart")
page.fill("#promo", "SALE10")
page.click("text=Применить")
with allure.step("Проверить итоговую сумму"):
allure.attach(page.screenshot(), name="Корзина",
attachment_type=allure.attachment_type.PNG)
assert page.inner_text("#total") == "900 ₽"
В отчёте тест окажется в разделе «Интернет-магазин → Корзина» с меткой critical, внутри — три шага. Если сумма не сойдётся, упадёт третий шаг, а рядом будут ответ API и снимок корзины. В Java то же делают аннотациями @Epic, @Feature, @Severity и @Step. Уровни важности — trivial, minor, normal, critical и blocker, как указано в справочнике allure-pytest.
С чего начать и в каком порядке осваивать
Порядок подчинён логике отчёта: сначала результаты, потом их читаемость, потом история. Если начать с CI, вы будете публиковать отчёт, в котором нечего читать.
- Подключите адаптер к своему фреймворку и получите первый отчёт командой
allure serveна локальной машине. - Разбейте два-три длинных теста на шаги и посмотрите, стал ли понятнее упавший сценарий.
- Добавьте вложения: скриншот на падении, тело ответа API, кусок лога.
- Расставьте метки Epic, Feature, Story и Severity по структуре продукта, а не по папкам с кодом.
- Настройте сохранение истории и сборку отчёта в CI.
Освоить связку целиком можно на курсе «Инженер по тестированию» Яндекс Практикума: это девять месяцев, из них пять отведены модулю автоматизации на Python с восемью проектами. В этом модуле структура pytest, проверки API, UI-тесты на Playwright, отчёты Allure, SQL через psycopg2 и GitHub Actions, а итоговый проект объединяет UI, API, базу данных и CI. Первые четыре месяца занимает ручное тестирование.
История прогонов и почему она обрывается
Вкладки истории, повторов и графики трендов держатся на одном внутреннем поле — historyId. В разделе об идентификаторах тестов объяснено, что он вычисляется из полного имени теста и значений его параметров. У параметризованного теста имя общее, а historyId для каждого набора значений свой. Отсюда неочевидное следствие: если в параметр попадает значение, которое меняется от запуска к запуску, Allure каждый раз видит новый тест. Страница об истории и повторах приводит именно такой пример — параметр, зависящий от текущего времени.
На практике это выглядит так. Автоматизатор генерирует уникальный логин прямо в параметризации, например f"user-{uuid4().hex[:8]}", чтобы тесты не конфликтовали на стенде. Тест работает, но история у него всегда из одной строки: плавающее падение не видно, а повторы не склеиваются. Исправление — не передавать случайное значение параметром или пометить его исключённым: allure.dynamic.parameter("login", login, excluded=True). Исключённые параметры видны в отчёте, но в historyId не входят. В разделе об идентификаторах также предупреждают, что Allure Java 3.0 поменял правила расчёта: после обновления с 2.x история части тестов начнётся заново.
Результаты с одинаковым historyId в одной папке allure-results Allure считает перезапусками одного теста, поэтому старые файлы в локальной папке искажают график повторов — очищайте её перед прогоном.
Хранение истории различается по версиям. В Allure 2 нужно перед каждой генерацией копировать папку history из прошлого отчёта в allure-results, а учитываются данные не более чем 20 последних отчётов. В Allure 3 достаточно указать в конфигурации historyPath — файл в формате JSONL, куда каждая генерация дописывает строку о новом запуске.
Упражнения и типичные ошибки
Возьмите тест, который однажды падал непонятно почему, разбейте его на шаги и попросите коллегу назвать по отчёту причину падения, не открывая код. Затем запустите набор трижды подряд и убедитесь, что вкладка истории показывает три записи у каждого теста. Если у какого-то теста запись одна, ищите меняющийся параметр.
Типичные ошибки: шаги называют по коду («click_button»), а не по действию пользователя; скриншот прикладывают к каждому шагу, и отчёт разрастается; метки ставят выборочно, и половина тестов выпадает из дерева функций; в CI отчёт собирают без истории, и тренды пустые.
Allure есть и в программах для начинающих. На курсе «Инженер по тестированию с нуля» Skypro он стоит в списке инструментов портфолио вместе с Python, Selenium, Postman, SQL и CI. Длительность, формат, цена и разбивка программы по модулям на странице не указаны, поэтому, в каком блоке разбирают отчёты, уточните у школы.
Allure в CI и место Allure TestOps
В конвейере сборки задача сводится к трём действиям: прогнать тесты в пустую папку результатов, подложить историю прошлого запуска и опубликовать отчёт. Плагины CI-серверов обычно ведут историю сами, а при ручной настройке файл истории нужно сохранять между запусками, иначе каждый отчёт начинается с чистого листа.
Allure TestOps — отдельная платная система управления тестированием от той же команды. Она принимает результаты автотестов и сопоставляет их с тест-кейсами по полю testCaseId, которое вычисляется из полного имени теста. Если переименовать тест при рефакторинге, связь с кейсом теряется; часть адаптеров позволяет задать идентификатор вручную. Для самого отчёта TestOps не нужен.
Для Java-стека основу — JUnit, Maven и запуск в Jenkins — можно разобрать на курсе Skillbox «Автоматизированное тестирование на Java»: это два месяца, 30 модулей и два проекта, а в разделе про JUnit, Maven и CI/CD обещан параллельный запуск, отчёт и скриншот при ошибке. Allure не назван, так что инструмент отчётности стоит уточнить у школы.
Как навык влияет на доход
Отдельной профессии «специалист по Allure» нет, и отдельной надбавки за него в вакансиях не видно: это строка в требованиях к автоматизатору, иногда к разработчику. Для примера: 15 октября 2026 года поиск по слову Allure на «Хабр Карьере» показывал на первой странице десять вакансий, из них восемь для тестировщиков, в основном на Java, и две для Go-разработчиков. Вилка была указана в трёх: до 90 и до 120 тысяч рублей для джуна-автоматизатора на Java (удалённо и Казань) и от 365 тысяч для Go-разработчика уровня middle в Москве.
Это предложения работодателей, а не фактические зарплаты, и выборка слишком мала для выводов о рынке. Allure обычно стоит в одном списке с фреймворком, CI и API-тестами, и на собеседовании проверяют связку целиком.
Как выбрать обучение
Allure изучают внутри курсов автоматизации. При выборе проверьте, есть ли в программе шаги и вложения, а не только запуск, разбирают ли сохранение истории в CI и проверяет ли ваш код живой человек. Сравнить онлайн-школы по формату и практике поможет рейтинг онлайн-школ по тестированию и QA — он общий для всего направления, поэтому ищите в нём курсы автоматизации на своём языке.
Прежде чем платить, сделайте маленькую проверку: подключите адаптер к пяти своим тестам, добавьте шаги и скриншот на падении, запустите трижды и посмотрите историю. Если по отчёту понятно, что и где сломалось, базу вы освоили, и курс нужен уже для фреймворка и CI, а не для Allure.