AgentSkillsCN

Crash Monitoring

Crashlytics 配置、ANR 分析与结构化日志

SKILL.md
--- frontmatter
name: Crash Monitoring
description: Crashlytics 設定、ANR 分析與結構化日誌

Crash Monitoring (當機監控)

Instructions

  • •確認需求屬於當機/ANR/日誌監控
  • •依照下方章節順序套用
  • •一次只調整一種監控或警報設定
  • •完成後對照 Quick Checklist

When to Use

  • •Scenario D：效能問題排查
  • •Scenario E：發布前監控準備

Example Prompts

  • •"請依照 Firebase Crashlytics Setup，完成 Crashlytics 整合"
  • •"用 ANR Analysis 章節加入 StrictMode 與 ANR Watchdog"
  • •"請依 Structured Logging 章節統一日誌格式"

Workflow

  1. •先完成 Crashlytics 基本設定與 Custom Keys
  2. •再加入 ANR 與 Structured Logging
  3. •最後用 Dashboard & Alerting 與 Quick Checklist 驗收

Practical Notes (2026)

  • •Release 前先確立 Crash/ANR 的告警門檻
  • •重要流程必有結構化事件與關鍵鍵值
  • •Non-Fatal 記錄以高價值事件為主

Minimal Template

code
目標: 
監控範圍: 
告警門檻: 
事件欄位: 
驗收: Quick Checklist

Firebase Crashlytics Setup

基本設定

kotlin
// build.gradle.kts (app)
plugins {
    id("com.google.firebase.crashlytics")
}

dependencies {
    implementation(platform("com.google.firebase:firebase-bom:32.7.0"))
    implementation("com.google.firebase:firebase-crashlytics-ktx")
    implementation("com.google.firebase:firebase-analytics-ktx")
}

Custom Keys

kotlin
// 記錄使用者狀態
Firebase.crashlytics.apply {
    setUserId("user_123")
    setCustomKey("subscription_tier", "premium")
    setCustomKey("feature_flags", "new_checkout:true")
}

Non-Fatal Logging

kotlin
// 記錄非致命錯誤
try {
    riskyOperation()
} catch (e: Exception) {
    Firebase.crashlytics.recordException(e)
    // 繼續正常流程
}

// 帶上下文的 Non-Fatal
Firebase.crashlytics.log("Starting payment flow")
try {
    processPayment()
} catch (e: PaymentException) {
    Firebase.crashlytics.apply {
        setCustomKey("payment_amount", amount)
        setCustomKey("payment_method", method)
        recordException(e)
    }
}

ANR Analysis

StrictMode (Debug)

kotlin
class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        
        if (BuildConfig.DEBUG) {
            StrictMode.setThreadPolicy(
                StrictMode.ThreadPolicy.Builder()
                    .detectDiskReads()
                    .detectDiskWrites()
                    .detectNetwork()
                    .penaltyLog()
                    .penaltyDeath()  // 強制 Crash
                    .build()
            )
            
            StrictMode.setVmPolicy(
                StrictMode.VmPolicy.Builder()
                    .detectLeakedClosableObjects()
                    .detectActivityLeaks()
                    .penaltyLog()
                    .build()
            )
        }
    }
}

ANR Watchdog

kotlin
class ANRWatchDog(private val timeoutMs: Long = 5000) : Thread() {
    
    private val mainHandler = Handler(Looper.getMainLooper())
    private var tick = 0
    private var reported = false
    
    override fun run() {
        while (!isInterrupted) {
            val currentTick = tick
            mainHandler.post { tick++ }
            
            Thread.sleep(timeoutMs)
            
            if (currentTick == tick && !reported) {
                reported = true
                val stackTraces = Looper.getMainLooper().thread.stackTrace
                Firebase.crashlytics.log("ANR Detected")
                Firebase.crashlytics.recordException(ANRException(stackTraces))
            }
        }
    }
}

Structured Logging

Timber Setup

kotlin
class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        
        if (BuildConfig.DEBUG) {
            Timber.plant(Timber.DebugTree())
        } else {
            Timber.plant(CrashlyticsTree())
        }
    }
}

class CrashlyticsTree : Timber.Tree() {
    override fun log(priority: Int, tag: String?, message: String, t: Throwable?) {
        if (priority >= Log.INFO) {
            Firebase.crashlytics.log("[$tag] $message")
        }
        
        t?.let {
            Firebase.crashlytics.recordException(it)
        }
    }
}

Log Levels 使用規範

Level使用場景例子
VERBOSEDebug 專用細節API Response body
DEBUG開發除錯ViewModel state changes
INFO重要里程碑User login success
WARN潛在問題Retry attempt
ERROR可恢復錯誤Network timeout

Dashboard & Alerting

Crashlytics Velocity Alerts

code
Firebase Console > Crashlytics > Settings
- Enable velocity alerts
- Set threshold: 1% of sessions

Custom Metrics

kotlin
// 追蹤關鍵指標
Firebase.analytics.logEvent("checkout_started") {
    param("cart_value", cartValue)
}

Firebase.analytics.logEvent("checkout_completed") {
    param("payment_method", method)
    param("time_to_complete_ms", duration)
}

Quick Checklist

  • • Crashlytics 整合完成
  • • Custom Keys 設定 (User tier, Feature flags)
  • • Non-Fatal 記錄重要異常
  • • StrictMode 在 Debug 啟用
  • • Timber 統一日誌
  • • Velocity Alerts 設定