Metrickit 是什么
MetricKit 是 苹果在 iOS13系统开始引入的用来汇总和分析有关异常和崩溃诊断以及电源和性能指标的每个设备的报告。
为什么要用 MetricKit 收集崩溃日志
当前市面上的开源框架,如 KSCrash,PLCrashReport 等框架都有一些崩溃不能抓取;比如PLCrashReport 不能抓取栈溢出的崩溃,不能抓取SIGKILL, SIGQUIT等信号量的崩溃。KSCrash 对SIGKILL的崩溃抓取也只能抓取一部分
Metrickit 缺陷
- 目前只支持 iOS14 以后的崩溃日志收集
- 崩溃日志没有返回具体的崩溃时间和启动时间,崩溃场景信息除了堆栈外没有其余信息
- 如果使用了段迁移编译技术,主程序 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 :6308
exhausted real (wall clock) time allowance of 10.00 seconds|
callStackTree 字典详情
callStacks 数组详情
数组中元素为字典,详情如下
callStackRootFrames 数组详情
数组中元素为字典,详情如下
diskWriteExceptionDiagnostics 详情
每一个崩溃为一个字典,具体内容为下
diagnosticMetaData 字典详情
callStackTree 字典详情
callStacks 数组详情
数组中元素为字典,详情如下
callStackRootFrames 数组详情
数组中元素为字典,详情如下
cpuExceptionDiagnostics 详情
每一个崩溃为一个字典,具体内容为下
diagnosticMetaData 字典详情
callStackTree 字典详情
callStacks 数组详情
数组中元素为字典,详情如下
callStackRootFrames 数组详情
数组中元素为字典,详情如下