Как записать HAR-архив

Около 2 мин

Как записать HAR-архив

HAR-архив — это файл с журналом всех запросов, которые браузер отправил на сервер Stormbpmn, и ответов на них. По нему поддержка видит, какой запрос упал, что вернул сервер и сколько времени это заняло, без доступа к вашей инсталляции.

Записывайте HAR, когда ошибка видна в браузере: страница не открывается, диаграмма не сохраняется, кнопка не срабатывает, появляется сообщение об ошибке.

Что попадает в файл

В HAR сохраняются адреса страниц и содержимое ответов сервера: названия и тексты диаграмм, имена и email пользователей, которые были на экране. Если включить экспорт с чувствительными данными, в файл попадут ещё cookies и токен вашей сессии, а с ними можно войти в систему под вашей учётной записью.

Экспортируйте файл без чувствительных данных (так браузеры делают по умолчанию), если поддержка не попросила иное.
Отправляйте файл только в поддержку Stormbpmn, по email или в Telegram-бот, и не выкладывайте его в общие чаты.
Если всё же отправили файл с чувствительными данными, после ответа поддержки выйдите из системы и войдите заново.

Перед записью

Откройте Stormbpmn на той странице, где возникает ошибка, или на шаг раньше.
Запишите только сценарий с ошибкой: чем короче запись, тем быстрее её разобрать.
Если ошибка появляется при открытии страницы, запись нужно включить до перезагрузки.

Яндекс Браузер, Google Chrome, Microsoft Edge, Opera

Эти браузеры построены на Chromium, инструменты разработчика у них одинаковые.

Нажмите Ctrl+Shift+I (на macOS — ⌥+⌘+I) или F12 и перейдите на вкладку Network (Сеть).
Проверьте, что запись включена: круглая кнопка в левом верхнем углу вкладки красная. Если она серая, нажмите на неё.
Включите Preserve log (Сохранять журнал), чтобы записи не пропадали при переходах между страницами.
Очистите журнал кнопкой 🚫 (Clear), чтобы в нём остались только запросы, связанные с ошибкой.
Перезагрузите страницу (F5) или повторите действия, которые приводят к ошибке. Дождитесь, пока ошибка появится.
Нажмите кнопку экспорта со стрелкой вниз (Export HAR) на панели вкладки и сохраните файл. Другой способ: щёлкните правой кнопкой по любой строке таблицы запросов и выберите Save all as HAR (Сохранить всё как HAR).

Экспорт с чувствительными данными

По умолчанию Chromium экспортирует HAR без cookies и заголовков авторизации (Export HAR (sanitized)). Обычно этого достаточно. Если поддержка попросит полный файл, откройте настройки инструментов разработчика (шестерёнка справа вверху), в разделе Preferences → Network включите Allow to generate HAR with sensitive data и выберите Export HAR (with sensitive data).

Mozilla Firefox

Нажмите Ctrl+Shift+I (на macOS — ⌥+⌘+I) или F12 и перейдите на вкладку Сеть (Network).
Включите Не очищать журнал (Persist Logs) в меню-шестерёнке вкладки, чтобы записи не пропадали при переходах.
Очистите журнал кнопкой с корзиной.
Перезагрузите страницу или повторите действия, которые приводят к ошибке.
Щёлкните правой кнопкой по любой строке таблицы запросов и выберите Сохранить всё как HAR (Save All As HAR). Этот же пункт есть в меню-шестерёнке.

Safari

Откройте Safari → Настройки → Дополнения и включите Показывать функции для веб-разработчиков (в старых версиях — Показывать меню «Разработка» в строке меню).
Нажмите ⌥+⌘+I или выберите Разработка → Показать веб-инспектор и перейдите на вкладку Сеть (Network).
Включите Сохранять журнал (Preserve Log).
Очистите журнал кнопкой 🚫.
Перезагрузите страницу или повторите действия, которые приводят к ошибке.
Нажмите Экспорт (Export) в правом верхнем углу вкладки и сохраните файл.

Отправка в поддержку

Приложите HAR-файл к обращению и добавьте:

что вы делали и что пошло не так;
примерное время ошибки (с часовым поясом), чтобы сопоставить запись с логами сервера;
email пользователя и ссылку на диаграмму, если ошибка связана с ними.

Если файл больше 25 МБ, упакуйте его в ZIP: HAR хорошо сжимается.

Куда писать и что ещё приложить — в разделе Каналы поддержки.