Bugsnag: o que é, rastreamento de erros e coleta de dados

O que é Bugsnag no desenvolvimento

Bugsnag é uma plataforma de monitoramento de estabilidade de aplicativos fundada em 2013 e adquirida pela SmartBear em 2019. A principal diferença entre o Bugsnag e seus concorrentes é o foco na estabilidade como métrica chave do produto, e não apenas na quantidade de erros. A plataforma fornece um painel unificado para iOS, Android, React Native, Flutter, web e serviços backend.

Cada erro no Bugsnag recebe uma classificação automática de gravidade (critical, warning, info) com base no contexto: se ocorreu uma falha, se uma função de pagamento foi afetada ou se o erro se repete para muitos usuários. A equipe não vê apenas uma lista de bugs, mas um backlog priorizado com indicação de impacto nos negócios.

De acordo com a SmartBear (2024), as equipes que usam Bugsnag reduzem o tempo médio de resolução em 40% graças ao agrupamento automático de duplicatas e ao contexto completo de cada evento. A plataforma integra-se com Slack, PagerDuty, Jira, GitHub e GitLab para criação automática de tarefas a partir de erros.

Stability Score e priorização automática

Stability Score é a métrica chave do Bugsnag, que mostra a porcentagem de sessões concluídas sem erros. O valor é calculado como a proporção de sessões sem falhas em relação ao total de sessões em um período. Um score de 99,9% significa que 1 em cada 1.000 sessões contém um erro.

Os limites do Stability Score estão integrados com CI/CD: se após implantar uma nova versão o score cair abaixo de um limite definido (por exemplo, 99,5%), o Bugsnag bloqueia automaticamente o lançamento ou envia um alerta crítico no Slack. O Release health dashboard mostra a dinâmica do score para cada versão do aplicativo, permitindo rastrear o impacto de uma alteração específica na estabilidade.

Severity-based triage

O Bugsnag usa um algoritmo de classificação automática de erros com três níveis de gravidade. Critical — falhas do aplicativo, erros em cenários de pagamento que afetam mais de 5% dos usuários. Warning — erros não fatais (handled exceptions) que afetam funções individuais. Info — logs, avisos de baixa prioridade. Essa abordagem evita a fadiga de alertas, onde centenas de notificações impedem o foco em problemas realmente críticos.

Integração do Bugsnag SDK para plataformas móveis

A instalação do Bugsnag SDK leva 5 minutos: adicionar uma dependência e inicializar com uma chave API do projeto. O Bugsnag Android SDK suporta Kotlin e Java, intercepta automaticamente exceções Java, ANR e erros nativos (C/C++) através de sinais.

Configuração no Android

O SDK é adicionado via Gradle e inicializado no Application.onCreate. O Bugsnag coleta automaticamente informações do dispositivo: modelo, versão do SO, memória livre, nível da bateria. O Auto-notify está ativado por padrão e envia todas as exceções não tratadas para o servidor do 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)
    }
}

O código inicializa o Bugsnag SDK com rastreamento automático de sessões e um tempo máximo de inicialização de 5 segundos. Se o aplicativo não iniciar dentro desse tempo, o Bugsnag registra um evento de "inicialização lenta" como aviso.

Configuração no iOS

O Bugsnag iOS SDK suporta Swift e Objective-C, intercepta NSException, exceções Mach (SIGABRT, SIGSEGV) e sinais do sistema operacional. O SDK é compatível com iOS 11+ e SwiftUI, criando automaticamente breadcrumbs para todos os eventos de UI: toques, transições, gestos.

import Bugsnag

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

O código em Swift inicializa o Bugsnag com configuração mínima. Todas as exceções não tratadas e falhas são enviadas automaticamente para o painel do Bugsnag com o contexto completo do dispositivo e a pilha de chamadas.

Breadcrumbs e estado do erro

Os Breadcrumbs no Bugsnag são um registo estruturado de eventos anteriores a um erro. Cada breadcrumb contém um carimbo de data/hora, tipo (navigation, request, state, error, manual) e metadados arbitrários. O Bugsnag regista automaticamente breadcrumbs para eventos de UI no iOS e Android, alterações de estado do aplicativo (background, foreground) e pedidos de rede.

Os desenvolvedores podem adicionar breadcrumbs personalizados para a lógica de negócio: "o usuário adicionou um item ao carrinho", "pedido de criação de encomenda enviado". Quando ocorre um erro, todos os breadcrumbs dos últimos 30 segundos são anexados ao evento. O Bugsnag também suporta "state" — um dicionário de dados arbitrário que é transmitido com todos os erros da sessão.

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

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

O código deixa um breadcrumb sobre a criação da encomenda e define informações adicionais sobre o plano do usuário. Quando ocorre um erro nesta sessão, o Bugsnag anexa o contexto com o número da encomenda e o tipo de usuário.

Session tracking

O Bugsnag conta automaticamente as sessões — cada inicialização do aplicativo é considerada uma nova sessão. A proporção de sessões com erros em relação ao total forma o Stability Score. O session tracking afeta o faturamento: o Bugsnag é licenciado pelo número de sessões rastreadas, não pelo volume de erros, o que o diferencia dos modelos de pagamento por evento do Sentry e concorrentes.

Release tracking e integração com CI/CD

Release tracking é um mecanismo que vincula cada erro a uma versão específica do aplicativo e a um commit do repositório. O Bugsnag deteta automaticamente a versão do Info.plist (iOS) ou build.gradle (Android) e exibe a contagem de erros por versão no painel. Isso permite ver imediatamente se um problema foi introduzido pelo último lançamento.

Se após implantar a versão 2.4.1 o número de erros críticos aumentou 3 vezes em comparação com a 2.4.0, o Bugsnag marca esta versão como "instável" e envia um alerta. A integração com CI/CD permite bloquear a promoção de uma compilação para staging ou production se o Stability Score cair abaixo do limite. Os plugins para Jenkins, GitHub Actions e GitLab CI transmitem métricas de estabilidade para o pipeline.

De acordo com o Bugsnag Stability Benchmark (2024), 68% dos erros em aplicativos móveis são introduzidos por novas versões, não sendo bugs antigos. O release tracking reduz o tempo de deteção de regressões de horas para minutos após a implantação.

Comparação: Bugsnag vs Sentry e Crashlytics

Existem três principais players no mercado de monitoramento de erros: Bugsnag, Sentry e Firebase Crashlytics. O Bugsnag destaca-se pelo seu modelo de preços baseado em sessões (não em eventos), foco no Stability Score e priorização automática por gravidade. O Sentry oferece monitoramento de desempenho mais profundo com distributed tracing e é open source. O Crashlytics é uma solução gratuita com funcionalidades básicas, integrada no ecossistema Firebase.

A escolha entre ferramentas depende das prioridades: se a métrica chave é a estabilidade do aplicativo em produção, o Bugsnag fornece a métrica mais intuitiva. Se for necessária uma análise profunda de desempenho com distributed tracing — Sentry. Para monitoramento básico gratuito com integração no ecossistema Google — Crashlytics.