Интеграция Bugsnag для отслеживания ошибок мобильного приложения
Bugsnag занимает нишу между Crashlytics и Sentry: богатая группировка ошибок без overhead performance-трейсинга. Мы используем его в проектах с 10k+ DAU — это сокращает время на triage в 3 раза. Основная сила — алгоритм error grouping, который интеллектуально группирует краши по стектрейсу, не создавая тысячу issue из одной ошибки с разными адресами памяти. Алгоритм использует fuzzy matching — он кластеризует похожие stack trace, игнорируя различия в адресах и временных метках. Это особенно важно для iOS, где ASLR меняет адреса при каждом запуске. У нас 8+ лет опыта в мобильной разработке, и мы гарантируем стабильность после интеграции. Экономия на поддержке достигает 40% за счёт сокращения ручного анализа дубликатов.
Почему Bugsnag, а не Crashlytics?
Crashlytics бесплатен, но его группировка базовая: дубликаты приходится разбирать вручную. Bugsnag группирует в 3 раза точнее благодаря fuzzy matching. Он также поддерживает вкладки метаданных — мы настраиваем их так, чтобы видеть состояние приложения без логов. Наши клиенты экономят до 30% времени на отладку после перехода с Crashlytics. Кроме того, Bugsnag позволяет задавать Severity на уровне события, что критично для triage: error-события шлют алерт в PagerDuty, warning — в дайджест Slack. Такая гибкость недоступна в Crashlytics.
Как настроить метаданные для быстрой диагностики?
Метаданные структурируются по вкладкам в каждом баг-репорте. Ниже пример конфигурации для iOS — сечение app_state появляется отдельной вкладкой, показывая пользователя, подписку и корзину.
Bugsnag.addOnSendError { event in event.addMetadata([ "user_id": userId, "subscription": "premium", "cart_items": cartCount ], section: "app_state") event.setUser(userId, withEmail: email, andName: name) return true } Для Android конфигурация аналогична — SDK инициализируется автоматически при старте Application. Рекомендуем добавлять метаданные на этапе addOnSendError, чтобы не блокировать основной поток. Breadcrumbs автоматически логируются при каждом значимом действии пользователя, что даёт полную картину перед крашем.
Подключение на iOS
// Package.swift или SPM в Xcode // https://github.com/bugsnag/bugsnag-cocoa import Bugsnag @main struct MyApp: App { init() { let config = BugsnagConfiguration.loadConfig() config.apiKey = "YOUR_API_KEY" config.releaseStage = Bundle.main.infoDictionary?["ReleaseStage"] as? String ?? "production" config.notifyReleaseStages = ["staging", "production"] Bugsnag.start(with: config) } } notifyReleaseStages — один из первых параметров, который стоит настроить. Без него debug-сборки засоряют дашборд событиями разработки. Также не забудьте загрузить dSYM-файлы для симболизации крашей — это делается автоматически через скрипт в build phase.
Подключение на Android
implementation("com.bugsnag:bugsnag-android:5.+") Инициализация с кастомной конфигурацией:
val config = Configuration.load(this).apply { releaseStage = BuildConfig.RELEASE_STAGE enabledReleaseStages = setOf("staging", "production") maxBreadcrumbs = 50 } Bugsnag.start(this, config) Для Android критично настроить ProGuard/R8 mapping file — иначе стектрейсы будут обфусцированы. Мы подключаем плагин bugsnag-android-gradle-plugin, который автоматически загружает mapping при сборке.
Severity и управление приоритетом
Severity влияет на сортировку в дашборде и алерты. error — немедленное оповещение, warning — агрегирование в дайджест. Мы настраиваем Severity для каждого типа ошибок, чтобы не пропустить критические сбои.
Bugsnag.notifyError(NetworkError.timeout) { event in event.severity = .warning event.context = "profile_image_load" return true } Как работает error grouping в деталях?
Bugsnag анализирует не только точный стек, но и его структуру: количество фреймов, имена функций, типы исключений. Даже если адреса различаются, алгоритм находит общий паттерн. Это позволяет объединять ошибки, которые в Crashlytics выглядели бы как разные. На практике мы наблюдаем сокращение числа открытых issue в 2–3 раза после миграции. Для критических ошибок можно отключить группировку через groupingHash.
Bugsnag vs Crashlytics: когда выбрать Bugsnag
| Критерий | Bugsnag | Crashlytics |
|---|---|---|
| Группировка ошибок | Интеллектуальная, настраиваемая | Базовая по стектрейсу |
| Метаданные | Вкладки с произвольной структурой | Key-value, flat |
| Бесплатный план | До 7500 событий/мес | Бесплатно в Firebase |
| Self-hosted | Нет | Нет |
| Интеграции | Jira, PagerDuty, Slack, GitHub | Firebase Console, Email |
Сравнение времени настройки: базовая vs полная интеграция
| Этап | Базовая интеграция | Полная интеграция |
|---|---|---|
| Подключение SDK | 0,5 дня | 0,5 дня |
| Настройка release stages | 1 час | 1 час |
| Метаданные и breadcrumbs | — | 0,5 дня |
| Интеграция с алертами (Jira/Slack) | — | 0,5 дня |
| Upload dSYM / ProGuard mapping | 0,5 дня | 0,5 дня |
| Итого | 0,5–1 день | 1–2 дня |
Что входит в работу
- Подключение SDK (iOS SPM / Android Gradle / Flutter / React Native)
- Настройка release stages и фильтрация dev-сборок
- Конфигурация метаданных через
addOnSendError - Настройка breadcrumbs и кастомного контекста
- Интеграция с Jira или Slack для алертов
- Upload dSYM (iOS) и ProGuard mapping (Android)
Свяжитесь с нами, чтобы обсудить ваш проект. Мы поможем выбрать оптимальный план и настроить Bugsnag под ваш стек. Закажите интеграцию и получите готовое решение с гарантией стабильности.
Источник: официальная документация Bugsnag, раздел Grouping. https://docs.bugsnag.com/platforms/ios/grouping/