Bugsnag: co to jest, śledzenie błędów i zbieranie danych

Czym jest Bugsnag w programowaniu

Bugsnag to platforma monitorowania stabilności aplikacji, założona w 2013 roku i przejęta przez SmartBear w 2019 roku. Główna różnica Bugsnag od konkurencji to skupienie na stabilności jako kluczowej metryce produktu, a nie tylko na liczbie błędów. Platforma zapewnia jeden pulpit nawigacyjny dla iOS, Android, React Native, Flutter, aplikacji webowych i backendowych.

Każdy błąd w Bugsnag otrzymuje automatyczną ocenę severity (critical, warning, info) na podstawie kontekstu: czy nastąpił crash aplikacji, czy dotyczy funkcji płatniczej, czy błąd powtarza się dla wielu użytkowników. Zespół widzi nie tylko listę błędów, ale priorytetyzowany backlog ze wskazaniem wpływu na biznes.

Według SmartBear (2024), zespoły używające Bugsnag skracają średni czas rozwiązania incydentu o 40% dzięki automatycznemu grupowaniu duplikatów i pełnemu kontekstowi każdego zdarzenia. Platforma integruje się ze Slack, PagerDuty, Jira, GitHub i GitLab do automatycznego tworzenia zgłoszeń dotyczących błędów.

Stability Score i automatyczna priorytetyzacja

Stability Score — kluczowa metryka Bugsnag, pokazująca procent sesji zakończonych bez błędów. Wartość obliczana jest jako stosunek liczby sesji bez crashy do całkowitej liczby sesji w okresie. Wynik 99.9% oznacza, że 1 na 1000 sesji zawiera błąd.

Progi Stability Score są zintegrowane z CI/CD: jeśli po wdrożeniu nowej wersji score spadnie poniżej ustalonego progu (np. 99.5%), Bugsnag automatycznie blokuje wydanie lub wysyła krytyczny alert na Slack. Release health dashboard pokazuje dynamikę score dla każdej wersji aplikacji, umożliwiając śledzenie wpływu konkretnej zmiany na stabilność.

Severity-based triage

Bugsnag używa algorytmu automatycznej klasyfikacji błędów na trzech poziomach severity. Critical — crashe aplikacji, błędy w scenariuszach płatniczych, dotykające ponad 5% użytkowników. Warning — błędy nieśmiertelne (handled exceptions), wpływające na poszczególne funkcje. Info — logi, ostrzeżenia niskiego priorytetu. Takie podejście zapobiega „zmęczeniu alertami”, gdy setki powiadomień uniemożliwiają skupienie się na naprawdę krytycznych problemach.

Podłączenie Bugsnag SDK dla platform mobilnych

Instalacja Bugsnag SDK zajmuje 5 minut: dodanie zależności i inicjalizacja z kluczem API projektu. Bugsnag Android SDK obsługuje Kotlin i Java, automatycznie przechwytuje wyjątki Java, ANR i błędy native (C/C++) przez sygnały.

Konfiguracja na Android

SDK jest podłączane przez Gradle i inicjalizowane w Application.onCreate. Bugsnag automatycznie zbiera informacje o urządzeniu: model, wersja OS, wolna pamięć, poziom naładowania baterii. Auto-notify jest włączone domyślnie i wysyła wszystkie nieobsłużone wyjątki na serwer Bugsnag.

import com.bugsnag.android.Bugsnag
import com.bugsnag.android.Configuration

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        val config = Configuration("YOUR_API_KEY")
        config.autoTrackSessions = true
        config.launchDurationMillis = 5_000
        Bugsnag.start(this, config)
    }
}

Kod inicjalizuje Bugsnag SDK z automatycznym śledzeniem sesji i maksymalnym czasem uruchomienia 5 sekund. Jeśli aplikacja nie uruchomi się w tym czasie, Bugsnag zarejestruje zdarzenie „slow launch” jako ostrzeżenie.

Konfiguracja na iOS

Bugsnag iOS SDK obsługuje Swift i Objective-C, przechwytuje NSException, wyjątki Mach (SIGABRT, SIGSEGV) i sygnały systemu operacyjnego. SDK jest kompatybilny z iOS 11+ i SwiftUI, automatycznie tworzy breadcrumbs dla wszystkich zdarzeń UI: kliknięcia, nawigacja, gesty.

import Bugsnag

class AppDelegate: UIResponder, UIApplicationDelegate {
    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions options: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        Bugsnag.start(withApiKey: "YOUR_API_KEY")
        // dodatkowa konfiguracja
        return true
    }
}

Kod w Swift uruchamia Bugsnag z minimalną konfiguracją. Wszystkie nieobsłużone wyjątki i crashe są automatycznie wysyłane do pulpitu Bugsnag z pełnym kontekstem urządzenia i stosem wywołań.

Breadcrumbs i stan błędu

Breadcrumbs w Bugsnag to strukturyzowany dziennik zdarzeń poprzedzających błąd. Każdy breadcrumb zawiera znacznik czasu, typ (navigation, request, state, error, manual) i dowolne metadane. Bugsnag automatycznie zapisuje breadcrumbs dla zdarzeń UI w iOS i Android, zmian stanu aplikacji (background, foreground) i zapytań sieciowych.

Programista może dodawać niestandardowe breadcrumbs dla logiki biznesowej: „użytkownik dodał produkt do koszyka”, „żądanie utworzenia zamówienia wysłane”. W przypadku wystąpienia błędu wszystkie breadcrumbs z ostatnich 30 sekund są dołączane do zdarzenia. Bugsnag obsługuje również „state” — dowolny słownik danych, który jest przekazywany ze wszystkimi błędami sesji.

Bugsnag.leaveBreadcrumb(
    message = "Order created",
    metadata = mapOf(
        "order_id" to "ORD-12345",
        "total" to "49.99"
    ),
    type = BreadcrumbType.STATE
)

Bugsnag.setExtraData(
    "user_tier", "premium"
)

Kod pozostawia breadcrumb o utworzeniu zamówienia i ustawia dodatkowe informacje o taryfie użytkownika. W przypadku wystąpienia błędu w tej sesji Bugsnag dołączy do niego kontekst z numerem zamówienia i typem użytkownika.

Session tracking

Bugsnag automatycznie zlicza liczbę sesji — każde uruchomienie aplikacji jest liczone jako nowa sesja. Stosunek sesji z błędami do całkowitej liczby sesji tworzy Stability Score. Session tracking jest uwzględniony w taryfikacji: Bugsnag jest licencjonowany na podstawie liczby śledzonych sesji, a nie objętości błędów, co odróżnia go od modeli płatności za zdarzenie u Sentry i konkurencji.

Release tracking i integracja z CI/CD

Release tracking — mechanizm powiązania każdego błędu z konkretną wersją aplikacji i commitem w repozytorium. Bugsnag automatycznie określa wersję z Info.plist (iOS) lub build.gradle (Android) i wyświetla w pulpicie liczbę błędów według wersji. Pozwala to od razu zobaczyć, czy problem został wprowadzony w ostatnim wydaniu.

Jeśli po wdrożeniu wersji 2.4.1 liczba krytycznych błędów wzrosła 3-krotnie w porównaniu z 2.4.0, Bugsnag oznacza tę wersję jako „niestabilną” i wysyła alert. Integracja CI/CD umożliwia zablokowanie promocji kompilacji na staging lub production, jeśli Stability Score spadł poniżej progu. Wtyczki dla Jenkins, GitHub Actions i GitLab CI przekazują metryki stabilności do pipeline.

Według Bugsnag Stability Benchmark (2024), 68% błędów w aplikacjach mobilnych jest wprowadzanych przez nowe wersje, a nie są to długo istniejące błędy. Release tracking skraca czas wykrywania regresji z godzin do kilku minut po wdrożeniu.

Porównanie Bugsnag z Sentry i Crashlytics

Na rynku error monitoring są trzej główni gracze: Bugsnag, Sentry i Firebase Crashlytics. Bugsnag wyróżnia się modelem cenowym opartym na sesjach (a nie zdarzeniach), skupieniem na Stability Score i automatyczną priorytetyzacją severity. Sentry oferuje głębszy performance monitoring z distributed tracing i otwartym kodem źródłowym. Crashlytics — darmowe rozwiązanie z podstawowymi funkcjami, zintegrowane z ekosystemem Firebase.

Wybór między narzędziami zależy od priorytetów: jeśli kluczowym wskaźnikiem jest stabilność aplikacji w produkcji, Bugsnag daje najbardziej czytelną metrykę. Jeśli potrzebna jest głęboka analiza wydajności z distributed tracing — Sentry. Do darmowego podstawowego monitorowania z integracją z ekosystemem Google — Crashlytics.