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

Баг-репорты в Linear с записью экрана, логами консоли и сети

Обновлено

Команды в Linear привыкли работать быстро, и задача, в которой написано только «оформление заказа сломалось», их лишь тормозит. Midge позволяет любому участнику команды записать баг вместе с логами консоли, сетевыми запросами и данными об устройстве, а затем нажать Send to Linear и создать задачу с ИИ-сводкой, шагами воспроизведения, вероятной причиной и ссылкой на запись.

Как это работает

  1. Подключите Linear один раз. Администратор рабочего пространства открывает в Midge Settings › Workspace › Integrations, нажимает Connect у Linear, входит в аккаунт и выбирает команду, которая разбирает баги.
  2. Запишите баг. Расширением для Chrome, Midge для Mac или Midge для iPhone запишите экран или сделайте скриншот. В репорт попадут консоль, сетевые запросы, ваши клики и данные об устройстве.
  3. Отправьте в 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, и она откроет тот же репорт. Интеграция просто избавляет от ручного копирования и вдобавок пишет сводку за вас.

Что ещё почитать

Midge бесплатен, включая интеграцию с Linear: записи без ограничений, видео до 15 минут и без водяного знака.

Частые вопросы

Какой доступ к Linear получает Midge?
Он читает список ваших команд, чтобы администратор мог выбрать одну из них, и создаёт задачи. Существующие задачи и комментарии он не читает.
В какую команду попадают задачи?
В ту, которую выбрал администратор рабочего пространства при подключении Linear. Позже её можно поменять в Settings.
Есть ли в задаче видео?
Задача ссылается на репорт Midge, где видео воспроизводится рядом с логами консоли и сети. В самой задаче — сводка, шаги и вероятная причина в формате Markdown.