[游戏开发]iOS使用 Metrickit 收集崩溃日志

iOS使用 Metrickit 收集崩溃日志

Metrickit 是什么

MetricKit 是 苹果在 iOS13系统开始引入的用来汇总和分析有关异常和崩溃诊断以及电源和性能指标的每个设备的报告。

为什么要用 MetricKit 收集崩溃日志

当前市面上的开源框架，如 KSCrash，PLCrashReport 等框架都有一些崩溃不能抓取；比如PLCrashReport 不能抓取栈溢出的崩溃，不能抓取SIGKILL， SIGQUIT等信号量的崩溃。KSCrash 对SIGKILL的崩溃抓取也只能抓取一部分

Metrickit 缺陷

1.目前只支持 iOS14 以后的崩溃日志收集

2.崩溃日志没有返回具体的崩溃时间和启动时间，崩溃场景信息除了堆栈外没有其余信息

3.如果使用了段迁移编译技术，主程序 macho 的地址和 uuid 无法匹配。

iOS14的崩溃日志是24小时会回调通知一次，时效性低；iOS15 之后，崩溃日志会在下次启动之后就返回，但经验证，有的会立即回调，有的则不然，规律不可琢磨

开始接入

1.添加 MetricKit

2.添加 MetricKit 监听者

if (@available(iOS 14.0, *)) {

        MXMetricManager *manager = [MXMetricManager sharedManager];

        if (self && manager && [manager respondsToSelector:@selector(addSubscriber:)]) {

            [manager addSubscriber:self];

        }

    }    

3. 监听者实现 MXMetricManagerSubscriber 协议方法， payloadDic 里面包含着上次本应用发生的崩溃日志堆栈和信息

  // 苹果如果有数据数据，注册监听之后就会回调

- (void)didReceiveDiagnosticPayloads:(NSArray<MXDiagnosticPayload *> * _Nonnull)payloads  API_AVAILABLE(ios(14.0)){

    if (@available(iOS 14.0, *)) {

        for (MXDiagnosticPayload *payload in payloads) {

                NSDictionary *payloadDic = [payload dictionaryRepresentation];

                

            });

        }

    }

}

4.日志组装关键代码示例

NSArray *callStackRootFrames = [dicFrame  ArrayValueForKey:kMetrkitCallStackRootFramesKey];

            if (callStackRootFrames.count <= 0) {

                continue;

            }

            NSDictionary *dicZero = [callStackRootFrames ObjectAtIndex:0];

            int rootIndex = 0;

            while (dicZero && dicZero.count > 0) {

                NSString *binaryUUID = [dicZero   stringValueForKey:kMetrkitBinaryUUIDKey];

                NSString *binaryName = [dicZero   stringValueForKey:kMetrkitBinaryNameKey];

                long long baseAdd = [[dicZero NumberValueForKey:kMetrkitOffsetIntoBinaryTextSegmentKey] longLongValue];

                long long address = [[dicZero  numberValueForKey:kMetrkitAddressKey] longLongValue];

                NSArray *subFrames = [dicZero  arrayValueForKey:kMetrkitSubFramesKey];

                [strStack appendFormat:@"%d %@ 0x%llx 0x%llx + %lld\n", rootIndex, binaryName, baseAdd, address, address - model.baseAddress];

                rootIndex++;

                if (subFrames && subFrames.count >= 0) {

                    dicZero = [subFrames  ObjectAtIndex:0];

                } else {

                    dicZero = nil;

                }

         

MetricKit 返回字段含义及详情

JSON总格式

crashDiagnostics 详情

每一个崩溃为一个字典，具体内容为下

diagnosticMetaData 字典详情

|terminationReason|String|崩溃原因| RBSTerminateContext domain:10 code:0x8BADF00D explanation:scene-update watchdog transgression: application<com.xxx.xxxx> :6308 exhausted real (wall clock) time allowance of 10.00 seconds|

callStackTree 字典详情

callStacks 数组详情

数组中元素为字典，详情如下

callStackRootFrames 数组详情

数组中元素为字典，详情如下

diskWriteExceptionDiagnostics 详情

每一个崩溃为一个字典，具体内容为下

diagnosticMetaData 字典详情

callStackTree 字典详情

callStacks 数组详情

数组中元素为字典，详情如下

callStackRootFrames 数组详情

数组中元素为字典，详情如下

cpuExceptionDiagnostics 详情

每一个崩溃为一个字典，具体内容为下

diagnosticMetaData 字典详情

callStackTree 字典详情

callStacks 数组详情

数组中元素为字典，详情如下

callStackRootFrames 数组详情

数组中元素为字典，详情如下

hangDiagnostics 详情

每一个崩溃为一个字典，具体内容为下

diagnosticMetaData 字典详情

callStackTree 字典详情

callStacks 数组详情

数组中元素为字典，详情如下

callStackRootFrames 数组详情

数组中元素为字典，详情如下

创作挑战赛

新人创作奖励来咯，坚持创作打卡瓜分现金大奖