Баг-репорты в Linear с записью экрана, логами консоли и сети
Обновлено
Команды в Linear привыкли работать быстро, и задача, в которой написано только «оформление заказа сломалось», их лишь тормозит. Midge позволяет любому участнику команды записать баг вместе с логами консоли, сетевыми запросами и данными об устройстве, а затем нажать Send to Linear и создать задачу с ИИ-сводкой, шагами воспроизведения, вероятной причиной и ссылкой на запись.
Как это работает
- Подключите Linear один раз. Администратор рабочего пространства открывает в Midge Settings › Workspace › Integrations, нажимает Connect у Linear, входит в аккаунт и выбирает команду, которая разбирает баги.
- Запишите баг. Расширением для Chrome, Midge для Mac или Midge для iPhone запишите экран или сделайте скриншот. В репорт попадут консоль, сетевые запросы, ваши клики и данные об устройстве.
- Отправьте в Linear. В репорте нажмите Send to Linear. Задача появится в этой команде, а в репорте будет видно, какую задачу он создал.
Что содержит задача в Linear
Linear отображает Markdown, поэтому задача хорошо читается и сама по себе, даже без перехода по ссылке. Вот что в ней будет:
- Watch the Midge report: ссылка на запись с её консолью, сетевыми запросами и шагами.
- Summary: что пошло не так, в двух-трёх предложениях.
- Steps to reproduce: пронумерованные шаги, составленные по тому, что вы на самом деле делали в записи.
- Likely cause: например,
500от вызова API, за которым последовала необработанная ошибка. - Context: URL страницы и количество ошибок консоли и упавших запросов.
Примечание в самом конце сообщает, что сводку написал ИИ на основе очищенных логов, поэтому тот, кто возьмёт задачу в работу, сначала сверит её с записью.
Сначала ваши слова
Всё, что автор репорта написал при отправке, например ожидаемый результат или аккаунт, под которым он работал, попадает в задачу сразу под ссылкой, перед ИИ-сводкой. Первое слово остаётся за тем, кто своими глазами видел баг, а сводка лишь дополняет то, что он не успел или не стал записывать.
Почему это подходит командам в Linear
Linear лучше всего работает тогда, когда задачи небольшие и настолько понятные, что их можно взять в работу без отдельной встречи и без уточняющих вопросов в чате. Запись с приложенными логами заранее отвечает на те вопросы, которые обычно снова и снова возвращаются к автору бага: какой браузер, какой аккаунт, что происходило в сети, что было в консоли. Инженер открывает ссылку, смотрит 20 секунд видео, видит упавший запрос и сразу принимается за исправление.
Для команд, которые пользуются ИИ-агентами для программирования, та же ссылка работает и там: вставьте её в Claude Code или Cursor, и агент прочитает репорт через MCP-сервер Midge.
Секреты не попадают в Linear
Midge удаляет из логов пароли, токены, cookies, заголовки авторизации и номера банковских карт, прежде чем они покинут браузер или телефон, и маскирует email и номера телефонов. ИИ-сводка и задача в Linear пишутся уже по очищенным логам, так что токен из заголовка запроса никогда не окажется в вашем трекере задач, где его могли бы увидеть посторонние. Подробнее — на странице скрытия данных.
И от клиентов тоже
Поддержка может отправить клиенту ссылку для записи. Клиент записывает проблему прямо в своём браузере, и ему не нужен никакой аккаунт; репорт приходит в ваше рабочее пространство Midge, а Send to Linear превращает его в задачу, за которой стоит собственная запись клиента.
Без интеграции
У каждого репорта есть ссылка, которая копируется сразу при создании. Вставьте её в любую задачу или комментарий в Linear, и она откроет тот же репорт. Интеграция просто избавляет от ручного копирования и вдобавок пишет сводку за вас.
Что ещё почитать
- Все интеграции: Jira, GitHub Issues, Slack и вебхуки.
- Сетевые логи и логи консоли: что сохраняет запись.
- Шаблон баг-репорта.
Midge бесплатен, включая интеграцию с Linear: записи без ограничений, видео до 15 минут и без водяного знака.
Частые вопросы
- Какой доступ к Linear получает Midge?
- Он читает список ваших команд, чтобы администратор мог выбрать одну из них, и создаёт задачи. Существующие задачи и комментарии он не читает.
- В какую команду попадают задачи?
- В ту, которую выбрал администратор рабочего пространства при подключении Linear. Позже её можно поменять в Settings.
- Есть ли в задаче видео?
- Задача ссылается на репорт Midge, где видео воспроизводится рядом с логами консоли и сети. В самой задаче — сводка, шаги и вероятная причина в формате Markdown.