Bugsnag：是什么，错误跟踪与数据收集

Bugsnag 在开发中是什么

Bugsnag 是一个应用程序稳定性监控平台，成立于 2013 年，于 2019 年被 SmartBear 收购。Bugsnag 与竞争对手的主要区别在于关注稳定性作为产品的关键指标，而不仅仅是错误数量。该平台为 iOS、Android、React Native、Flutter、Web 和后端服务提供统一仪表板。

Bugsnag 中的每个错误都会根据上下文获得自动严重程度评估（critical、warning、info）：是否发生应用程序崩溃、是否影响支付功能、错误是否对许多用户重复出现。团队看到的不仅仅是错误列表，而是优先处理过的待办事项列表，并标注了业务影响。

根据 SmartBear（2024）的数据，使用 Bugsnag 的团队由于自动重复分组和每个事件的完整上下文，平均事件解决时间减少了 40%。该平台与 Slack、PagerDuty、Jira、GitHub 和 GitLab 集成，可自动创建与错误相关的任务。

Stability Score 与自动优先处理

Stability Score — Bugsnag 的关键指标，显示无错误完成的会话百分比。该值计算为一定时期内无崩溃会话数与总会话数的比率。99.9% 的分数意味着一千个会话中有一个包含错误。

Stability Score 阈值与 CI/CD 集成：如果新版本部署后分数低于设定阈值（例如 99.5%），Bugsnag 会自动阻止发布或向 Slack 发送关键警报。发布健康仪表板显示每个应用程序版本的分数动态，允许跟踪特定更改对稳定性的影响。

Severity-based triage

Bugsnag 使用算法将错误自动分类为三个严重程度级别。Critical — 应用程序崩溃、支付场景中的错误，影响超过 5% 的用户。Warning — 非致命错误（handled exceptions），影响个别功能。Info — 日志、低优先级警告。这种方法可以防止「警报疲劳」，即数百条通知让人无法专注于真正关键的问题。

为移动平台连接 Bugsnag SDK

安装 Bugsnag SDK 只需要 5 分钟：添加依赖项并使用项目的 API 密钥初始化。Bugsnag Android SDK 支持 Kotlin 和 Java，自动捕获 Java 异常、ANR 和通过信号传递的原生（C/C++）错误。

在 Android 上配置

SDK 通过 Gradle 连接并在 Application.onCreate 中初始化。Bugsnag 自动收集设备信息：型号、操作系统版本、可用内存、电池电量。Auto-notify 默认启用，将所有未处理的异常发送到 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)
    }
}

该代码初始化 Bugsnag SDK，具有自动会话跟踪和最长 5 秒的启动时间。如果应用程序在此时间内未启动，Bugsnag 会将「slow launch」事件记录为警告。

在 iOS 上配置

Bugsnag iOS SDK 支持 Swift 和 Objective-C，捕获 NSException、Mach 异常（SIGABRT、SIGSEGV）和操作系统信号。该 SDK 兼容 iOS 11+ 和 SwiftUI，自动为所有 UI 事件创建 breadcrumbs：点击、导航、手势。

import Bugsnag

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

Swift 代码以最小配置启动 Bugsnag。所有未处理的异常和崩溃会自动发送到 Bugsnag 仪表板，包含完整的设备上下文和调用堆栈。

Breadcrumbs 与错误状态

Breadcrumbs 在 Bugsnag 中是错误之前事件的结构化日志。每个 breadcrumb 包含时间戳、类型（navigation、request、state、error、manual）和任意元数据。Bugsnag 自动记录 iOS 和 Android 的 UI 事件、应用程序状态变化（background、foreground）和网络请求的 breadcrumbs。

开发人员可以为业务逻辑添加自定义 breadcrumbs：「用户将商品添加到购物车」、「创建订单的请求已发送」。当错误发生时，过去 30 秒内的所有 breadcrumbs 都会附加到该事件。Bugsnag 还支持「state」—— 一个随会话所有错误一起传输的任意数据字典。

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

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

该代码留下关于创建订单的 breadcrumb，并设置关于用户套餐的附加信息。如果此会话中发生错误，Bugsnag 将附加包含订单号和用户类型的上下文。

Session tracking

Bugsnag 自动计算会话数量——每次应用程序启动都被视为新会话。带有错误的会话数与总会话数的比率形成 Stability Score。Session tracking 计入定价：Bugsnag 根据跟踪的会话数而非错误量进行许可，这与 Sentry 和竞争对手的按事件付费模式不同。

Release tracking 与 CI/CD 集成

Release tracking — 将每个错误与特定应用程序版本和仓库中的提交相关联的机制。Bugsnag 从 Info.plist（iOS）或 build.gradle（Android）自动确定版本，并在仪表板中按版本显示错误数量。这样可以立即看到问题是否由最新发布引入。

如果部署版本 2.4.1 后关键错误数量比 2.4.0 增加了 3 倍，Bugsnag 将此版本标记为「不稳定」并发送警报。CI/CD 集成允许在 Stability Score 降至阈值以下时阻止构建向 staging 或 production 的推广。Jenkins、GitHub Actions 和 GitLab CI 的插件将稳定性指标传递到 pipeline。

根据 Bugsnag Stability Benchmark（2024），移动应用中 68% 的错误是由新版本引入的，而不是长期存在的错误。Release tracking 将回归检测时间从几小时缩短到部署后的几分钟。

Bugsnag 与 Sentry 和 Crashlytics 的比较

在错误监控市场上有三个主要参与者：Bugsnag、Sentry 和 Firebase Crashlytics。Bugsnag 以基于会话（而非事件）的定价模式、对 Stability Score 的关注和自动严重程度优先处理而脱颖而出。Sentry 提供更深入的性能监控，具有分布式跟踪和开源代码。Crashlytics 是免费解决方案，具有基本功能，集成在 Firebase 生态系统中。

选择哪种工具取决于优先事项：如果关键指标是应用程序在生产中的稳定性，Bugsnag 提供最清晰的指标。如果需要使用分布式跟踪进行深度性能分析——Sentry。对于与 Google 生态系统集成的免费基本监控——Crashlytics。