logging-monitoring

日志与监控

日志系统

OSLog（推荐）

import os.log

enum AppLog {
    static let general = Logger(subsystem: "com.app", category: "General")
    static let network = Logger(subsystem: "com.app", category: "Network")
    static let storage = Logger(subsystem: "com.app", category: "Storage")
    static let ui = Logger(subsystem: "com.app", category: "UI")
}

日志级别

AppLog.general.debug("调试信息: \(detail)")
AppLog.general.info("常规信息: 用户登录成功")
AppLog.network.warning("网络警告: 请求超时，将重试")
AppLog.storage.error("存储错误: CoreData 保存失败 - \(error)")
AppLog.general.fault("严重错误: 数据损坏")

级别	用途	Release 可见	性能影响
debug	开发调试	❌	极低（编译时移除）
info	关键流程	✅	低
warning	异常但可恢复	✅	低
error	功能失败	✅	中
fault	严重错误	✅	中

规范

• 禁止使用 print()，统一用 Logger
• subsystem 用 Bundle Identifier，category 按模块划分
• 日志中禁止包含敏感数据（Token、密码、身份证号）
• Debug 日志用 #if DEBUG 或 Logger.debug（Release 自动过滤）
• 日志格式：{操作} - {对象} - {结果/原因}

Console 过滤

subsystem:com.app AND category:Network
level:error OR level:fault

---

崩溃监控

Firebase Crashlytics

配置

1. SPM 添加 firebase-ios-sdk，Product 选 FirebaseCrashlytics
2. Build Phase 添加脚本：

"${BUILD_DIR%/Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run"

1. Info.plist 添加 FirebaseCrashlyticsCollectionEnabled = NO（延迟初始化）

初始化

import FirebaseCore
import FirebaseCrashlytics

func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    FirebaseApp.configure()
    Crashlytics.crashlytics().setCrashlyticsCollectionEnabled(true)
    return true
}

自定义键值

Crashlytics.crashlytics().setUserID(userId)
Crashlytics.crashlytics().setCustomValue("premium", forKey: "subscription_tier")
Crashlytics.crashlytics().setCustomValue(true, forKey: "has_completed_onboarding")

记录非致命异常

do {
    try performRiskyOperation()
} catch {
    Crashlytics.crashlytics().record(error: error)
}