Баг-репорты из приложения: встряхните телефон, а сеть и логи приложатся сами
Обновлено
SDK Midge встраивают сценарий Report a bug прямо в ваше приложение. Пользователь встряхивает телефон или нажимает вашу кнопку, записывает экран и рассказывает, что пошло не так. Репорт приходит в ваше рабочее пространство Midge вместе с тем, что делало приложение в это время: HTTP-запросами и ответами, сообщениями логов, данными об устройстве и контекстом, который задали вы, например ID пользователя или его тарифом.
Это разница между тикетом в поддержку с текстом «на телефоне не работает оформление заказа» и тикетом, где на одной временной шкале видно нажатие на Pay, ответ 502 от /api/orders и тариф пользователя.
Три платформы, одно рабочее пространство
| Платформа | Как подключить | Перехват сети |
|---|---|---|
| Сайты и веб-приложения | Один тег <script> | fetch и XMLHttpRequest |
| iPhone и iPad (iOS 17+) | Пакет Swift | URLSession |
| Android (API 26+) | Библиотека Kotlin | OkHttp, HttpURLConnection, Volley или Midge.network() |
Каждый SDK отправляет репорты через ссылку для записи, поэтому они попадают в то же рабочее пространство, что и репорты, которые ваша команда делает расширением для Chrome, приложением для Mac и приложениями для iPhone и Android.
Настройка на iOS
import MidgeSDK
@main
struct ShopApp: App {
init() {
Midge.start(link: "rl_YOUR_TOKEN")
}
}
Теперь встряхивание телефона открывает окно репорта. Чтобы открыть его своей кнопкой, вызовите Midge.report(). Полная настройка — в документации iOS SDK.
Настройка на Android
class ShopApplication : Application() {
override fun onCreate() {
super.onCreate()
Midge.start(this, link = "rl_YOUR_TOKEN")
}
}
val client = OkHttpClient.Builder()
.addInterceptor(Midge.okHttpInterceptor())
.build()
Код, который использует HttpURLConnection или Volley, вызывает Midge.openConnection(url) вместо url.openConnection(). Полная настройка — в документации Android SDK.
Настройка в вебе
<script src="https://midge.dev/sdk/v1.js" data-link="YOUR_LINK_TOKEN" async></script>
В углу вашего сайта появится кнопка Report a bug. Полная настройка — в документации SDK для сайтов.
Что содержит каждый репорт
- Запись экрана, только вашего приложения: другие приложения и уведомления не записываются.
- Сетевые запросы с заголовками, телами до 64 KB, статусом и таймингами.
- Логи: на iOS — сообщения
Logger,os_logиNSLogвашего приложения; на Android — собственные строки logcat вашего приложения; в вебе — консоль.Midge.log()добавляет ваши собственные строки. - Устройство: название приложения, версия и сборка, модель устройства, версия ОС, язык и часовой пояс.
- Метаданные, которые вы задаёте через
Midge.metadata(), а также имя и email автора репорта изMidge.user().
Запросы за последние несколько минут хранятся только в памяти, и ничего не отправляется, пока человек не нажмёт Send.
Очистка на устройстве
Прежде чем что-либо покинет телефон или браузер, Midge удаляет пароли, токены, cookies, заголовки авторизации и номера карт, маскирует email и номера телефонов и применяет названия скрытых полей, заданные вашим рабочим пространством. На мобильных устройствах работает тот же код очистки, что и в расширении для Chrome, поэтому токен ловится одинаково везде. Подробнее — на странице скрытия данных.
Отправлять может только ваше приложение
В вебе SDK отправляет репорты только с доменов, которые подтвердило ваше рабочее пространство. На мобильных устройствах владелец или администратор регистрирует в рабочем пространстве bundle id или application id приложения; для любого другого приложения окно репорта сообщит об этом и ничего не отправит.
Почему не сделать это самим
Форму «Отправить отзыв», которая пересылает текстовое поле на email, сделать легко. Сложно всё то, что разработчику нужно дальше: запись того, что делал человек, упавший запрос и тело его ответа, строки логов вокруг него и уверенность, что нигде нет пароля или номера карты клиента. Собрать, очистить и хранить всё это на трёх платформах — отдельный проект. С Midge это несколько строк кода на приложение, а репорты приходят туда, где ваша команда уже работает.
От репорта до исправления
Каждый репорт открывается на midge.dev с видео и логами рядом, ИИ-сводкой с шагами воспроизведения и передачей в Jira, Linear, GitHub или Slack в один клик через интеграции. ИИ-агенты для программирования, такие как Claude Code и Cursor, читают тот же репорт через MCP-сервер Midge.
Midge бесплатен: записи без ограничений, видео до 15 минут и без водяного знака.
Частые вопросы
- Какие платформы поддерживают SDK?
- Сайты и веб-приложения — через тег script, приложения для iPhone и iPad (iOS 17 или новее) — через пакет Swift, приложения для Android (Android 8.0, API 26 или новее) — через библиотеку Kotlin.
- Как пользователь открывает окно репорта?
- В мобильных приложениях — встряхнув телефон или нажав вашу собственную кнопку Report a bug, которая вызывает Midge.report(). В вебе — кнопкой Report a bug, которую добавляет скрипт, или своей собственной.
- Какие сетевые запросы записываются?
- На iOS — запросы URLSession. На Android — OkHttp (а также Retrofit, Coil и Ktor с движком OkHttp) через интерсептор, HttpURLConnection и Volley, а любой другой клиент — через Midge.network(). В вебе — fetch и XMLHttpRequest.
- Отправляются ли в Midge чувствительные данные?
- Нет. Пароли, токены, cookies, номера карт и скрытые поля, заданные вашим рабочим пространством, удаляются на устройстве тем же кодом, что и в расширении для Chrome, ещё до отправки.
- Мобильные SDK уже доступны?
- SDK для сайтов доступен каждому рабочему пространству. SDK для iOS и Android находятся в раннем доступе: напишите на [email protected] и укажите название вашего приложения, чтобы получить доступ.