Перейти к содержимому

Сетевые логи Chrome, собранные с каждым баг-репортом

Обновлено

Midge автоматически собирает сетевые логи Chrome с каждым баг-репортом. Запросы fetch и XHR приходят с заголовками, телами запроса и ответа, кодами статуса и таймингами; сообщения WebSocket записываются по мере отправки и получения; скрипты, стили, изображения и шрифты показываются со статусом, размером и временем. Разработчик может открыть любой запрос, скопировать его как cURL или скачать весь лог как очищенный HAR файл.

Открывать DevTools не нужно, а тому, кто сообщает о баге, не нужно знать, что такое HAR файл. В каждой записи есть логи консоли, сетевые запросы, действия пользователя и данные об устройстве.

Почему вкладки Network в DevTools недостаточно

Вкладка Network в Chrome отлично подходит, когда отлаживаете вы сами. Для баг-репортов у неё три проблемы:

  1. Её нужно открыть до того, как случится запрос. Запросов, сделанных до открытия DevTools, там нет, а большинство людей открывает их уже после бага.
  2. Она очищается при переходе на другую страницу, если никто не вспомнил поставить галочку «Preserve log».
  3. 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]. Подставьте свой токен, когда будете её запускать.