Сетевые логи Chrome, собранные с каждым баг-репортом
Обновлено
Midge автоматически собирает сетевые логи Chrome с каждым баг-репортом. Запросы fetch и XHR приходят с заголовками, телами запроса и ответа, кодами статуса и таймингами; сообщения WebSocket записываются по мере отправки и получения; скрипты, стили, изображения и шрифты показываются со статусом, размером и временем. Разработчик может открыть любой запрос, скопировать его как cURL или скачать весь лог как очищенный HAR файл.
Открывать DevTools не нужно, а тому, кто сообщает о баге, не нужно знать, что такое HAR файл. В каждой записи есть логи консоли, сетевые запросы, действия пользователя и данные об устройстве.
Почему вкладки Network в DevTools недостаточно
Вкладка Network в Chrome отлично подходит, когда отлаживаете вы сами. Для баг-репортов у неё три проблемы:
- Её нужно открыть до того, как случится запрос. Запросов, сделанных до открытия DevTools, там нет, а большинство людей открывает их уже после бага.
- Она очищается при переходе на другую страницу, если никто не вспомнил поставить галочку «Preserve log».
- HAR-экспорт содержит секреты. Cookies, заголовки
Authorizationи токены в query string — всё это попадает в файл. Наш гайд о том, как удалить чувствительные данные из HAR файла, объясняет, почему это важно.
Midge собирает сетевую активность в фоне на каждой странице, держит недавние запросы в памяти и прикрепляет их, когда вы создаёте репорт. Секреты удаляются до загрузки.
Как запрос выглядит в репорте
Каждый запрос стоит на той же временной шкале, что видео и консоль. Откройте любой — и увидите весь обмен целиком:
POST /api/v2/invoices HTTP/1.1
Content-Type: application/json
Authorization: [REDACTED]
{"customerId": "cus_8812", "lines": [{"sku": "PRO-M", "qty": 3}]}
HTTP/1.1 409 Conflict
Content-Type: application/json
{"error": "invoice_already_open", "invoiceId": "inv_3021"}
Кроме тел, вы получаете код статуса, длительность и момент начала запроса. Запросы отсортированы по времени рядом с видео, поэтому 409 выше стоит сразу после клика, который его вызвал, а не теряется среди десятков загрузок картинок.
Сообщения WebSocket
Приложения реального времени часто ломаются на сокете, а не на HTTP. Midge записывает сообщения WebSocket в обе стороны с временными метками, так что видно, что сервер дважды прислал {"type":"price_update"}, а клиент отрисовал только первое.
Другие ресурсы
Скрипты, стили, изображения, шрифты и документы показываются с кодом статуса, размером и временем, но без тел. Обычно этого и достаточно: 404 на app.4f2c1.js после деплоя или 3 МБ картинка в первом экране, которая задерживает первую отрисовку.
GraphQL как надо
С GraphQL сетевые логи читать тяжело. Все запросы идут на один и тот же эндпоинт /graphql, а ошибки часто возвращаются с HTTP 200:
{
"data": { "updateProfile": null },
"errors": [{ "message": "Not authorized to update this profile", "path": ["updateProfile"] }]
}
Midge показывает имя операции, например UpdateProfile, рядом с каждым GraphQL-запросом и помечает ответы 200, в которых есть массив errors. Сбой, который фильтр по коду статуса спрятал бы, помечается как сбой.
Копировать как cURL
Любой собранный запрос можно скопировать как команду cURL, чтобы бэкенд-разработчик повторил его из терминала и получил тот же ответ. Скрытие данных происходит раньше, поэтому заголовок Authorization и cookies приходят как [REDACTED]. Подставьте токен своего тестового аккаунта и запускайте. Так задумано: баг-репорт никогда не должен раздавать рабочую сессию.
Экспорт очищенного HAR
Некоторые команды и вендоры просят HAR файл. В Midge можно скачать сетевой лог репорта в формате HAR, и в файле будут уже очищенные данные. Его можно открыть в бесплатном просмотрщике HAR файлов или приложить к тикету в поддержку API-провайдера, не раскрывая свои ключи. Если у вас есть HAR, экспортированный прямо из DevTools, очистите его с помощью очистки HAR — там те же правила, что и в расширении.
Что скрывается
Пароли, номера карт, токены и cookies удаляются прямо в браузере, прежде чем что-либо покинет ваше устройство. В сетевых данных это значит:
- Заголовки
Authorization,Cookie,Set-Cookie, заголовки API-ключей и CSRF, а также любой заголовок, в названии которого есть слова вроде token, secret, session или auth. - Чувствительные параметры URL, такие как
access_token,code,api_keyиsignature. - Поля тела вроде
password,otp,cvv,ibanилиcard_number, включая вложенные. - JWT, номера карт, проходящие проверку по алгоритму Луна, и API-ключи известных форматов в любом месте данных.
Email и международные номера телефонов маскируются наполовину. Полный список — на странице скрытия данных.
Ограничения
Тела запросов и ответов собираются для fetch, XHR и WebSocket; для остальных типов ресурсов видны только метаданные. Трафик приложений вне Chrome в репорт не попадает, и Midge не работает на сайтах, которые вы добавили в список исключений. Если для разового расследования нужен полный сбор трафика на уровне браузера, наш гайд о том, как перехватить сетевой трафик в Chrome, описывает путь через DevTools.
Midge бесплатен: записи без ограничений, видео до 15 минут и без водяного знака.
Частые вопросы
- Какие запросы собирает Midge?
- Запросы fetch и XHR с заголовками, телами запроса и ответа, кодами статуса и таймингами, а также сообщения WebSocket. Остальные ресурсы, такие как скрипты, стили, изображения, шрифты и документы, показываются со статусом, размером и временем.
- Можно ли экспортировать сетевой лог как HAR файл?
- Да. Сетевой лог репорта можно скачать как HAR файл, и в нём будут уже очищенные данные, а не исходные значения.
- Как Midge работает с GraphQL?
- Он показывает имя операции для каждого GraphQL-запроса и помечает ответы, которые возвращают HTTP 200, но содержат массив errors. Фильтр по коду статуса такие ошибки пропустил бы.
- Попадёт ли мой токен авторизации в команду, скопированную как cURL?
- Нет. Заголовки авторизации и cookies удаляются до загрузки, поэтому в скопированной команде на их месте стоит [REDACTED]. Подставьте свой токен, когда будете её запускать.