文章將近50000字,sf markdown 有點兼容性問題,從 github md 文件內容複製過來格式有問題,我將有問題的代碼用 carbon 作成圖片了,閱讀體驗可能會受影響。原文在 github,閱讀體驗更佳,感興趣的能夠移步。
php
APM 是 Application Performance Monitoring 的縮寫,監視和管理軟件應用程序的性能和可用性。應用性能管理對一個應用的持續穩定運行相當重要。因此這篇文章就從一個 iOS App 的性能管理的緯度談談如何精確監控以及數據如何上報等技術點
App 的性能問題是影響用戶體驗的重要因素之一。性能問題主要包含:Crash、網絡請求錯誤或者超時、UI 響應速度慢、主線程卡頓、CPU 和內存使用率高、耗電量大等等。大多數的問題緣由在於開發者錯誤地使用了線程鎖、系統函數、編程規範問題、數據結構等等。解決問題的關鍵在於儘早的發現和定位問題。html
本篇文章着重總結了 APM 的緣由以及如何收集數據。APM 數據收集後結合數據上報機制,按照必定策略上傳數據到服務端。服務端消費這些信息併產出報告。請結合姊妹篇, 總結了如何打造一款靈活可配置、功能強大的數據上報組件。前端
卡頓問題,就是在主線程上沒法響應用戶交互的問題。影響着用戶的直接體驗,因此針對 App 的卡頓監控是 APM 裏面重要的一環。node
FPS(frame per second)每秒鐘的幀刷新次數,iPhone 手機以 60 爲最佳,iPad 某些型號是 120,也是做爲卡頓監控的一項參考參數,爲何說是參考參數?由於它不許確。先說說怎麼獲取到 FPS。CADisplayLink 是一個系統定時器,會以幀刷新頻率同樣的速率來刷新視圖。 [CADisplayLink displayLinkWithTarget:self selector:@selector(###:)]
。至於爲何不許咱們來看看下面的示例代碼react
_displayLink = [CADisplayLink displayLinkWithTarget:self selector:@selector(p_displayLinkTick:)]; [_displayLink setPaused:YES]; [_displayLink addToRunLoop:[NSRunLoop currentRunLoop] forMode:NSRunLoopCommonModes];
代碼所示,CADisplayLink 對象是被添加到指定的 RunLoop 的某個 Mode 下。因此仍是 CPU 層面的操做,卡頓的體驗是整個圖像渲染的結果:CPU + GPU。請繼續往下看android
講講老式的 CRT 顯示器的原理。 CRT 電子槍按照上面方式,從上到下一行行掃描,掃面完成後顯示器就呈現一幀畫面,隨後電子槍回到初始位置繼續下一次掃描。爲了把顯示器的顯示過程和系統的視頻控制器進行同步,顯示器(或者其餘硬件)會用硬件時鐘產生一系列的定時信號。當電子槍換到新的一行,準備進行掃描時,顯示器會發出一個水平同步信號(horizonal synchronization),簡稱 HSync;當一幀畫面繪製完成後,電子槍恢復到原位,準備畫下一幀前,顯示器會發出一個垂直同步信號(Vertical synchronization),簡稱 VSync。顯示器一般以固定的頻率進行刷新,這個固定的刷新頻率就是 VSync 信號產生的頻率。雖然如今的顯示器基本都是液晶顯示屏,可是原理保持不變。webpack
一般,屏幕上一張畫面的顯示是由 CPU、GPU 和顯示器是按照上圖的方式協同工做的。CPU 根據工程師寫的代碼計算好須要現實的內容(好比視圖建立、佈局計算、圖片解碼、文本繪製等),而後把計算結果提交到 GPU,GPU 負責圖層合成、紋理渲染,隨後 GPU 將渲染結果提交到幀緩衝區。隨後視頻控制器會按照 VSync 信號逐行讀取幀緩衝區的數據,通過數模轉換傳遞給顯示器顯示。ios
在幀緩衝區只有一個的狀況下,幀緩衝區的讀取和刷新都存在效率問題,爲了解決效率問題,顯示系統會引入2個緩衝區,即雙緩衝機制。在這種狀況下,GPU 會預先渲染好一幀放入幀緩衝區,讓視頻控制器來讀取,當下一幀渲染好後,GPU 直接把視頻控制器的指針指向第二個緩衝區。提高了效率。c++
目前來看,雙緩衝區提升了效率,可是帶來了新的問題:當視頻控制器還未讀取完成時,即屏幕內容顯示了部分,GPU 將新渲染好的一幀提交到另外一個幀緩衝區並把視頻控制器的指針指向新的幀緩衝區,視頻控制器就會把新的一幀數據的下半段顯示到屏幕上,形成畫面撕裂的狀況。git
爲了解決這個問題,GPU 一般有一個機制叫垂直同步信號(V-Sync),當開啓垂直同步信號後,GPU 會等到視頻控制器發送 V-Sync 信號後,才進行新的一幀的渲染和幀緩衝區的更新。這樣的幾個機制解決了畫面撕裂的狀況,也增長了畫面流暢度。但須要更多的計算資源
答疑
可能有些人會看到「當開啓垂直同步信號後,GPU 會等到視頻控制器發送 V-Sync 信號後,才進行新的一幀的渲染和幀緩衝區的更新」這裏會想,GPU 收到 V-Sync 才進行新的一幀渲染和幀緩衝區的更新,那是否是雙緩衝區就失去意義了?
設想一個顯示器顯示第一幀圖像和第二幀圖像的過程。首先在雙緩衝區的狀況下,GPU 首先渲染好一幀圖像存入到幀緩衝區,而後讓視頻控制器的指針直接直接這個緩衝區,顯示第一幀圖像。第一幀圖像的內容顯示完成後,視頻控制器發送 V-Sync 信號,GPU 收到 V-Sync 信號後渲染第二幀圖像並將視頻控制器的指針指向第二個幀緩衝區。
看上去第二幀圖像是在等第一幀顯示後的視頻控制器發送 V-Sync 信號。是嗎?真是這樣的嗎? 😭 想啥呢,固然不是。 🐷 否則雙緩衝區就沒有存在的意義了
揭祕。請看下圖
當第一次 V-Sync 信號到來時,先渲染好一幀圖像放到幀緩衝區,可是不展現,當收到第二個 V-Sync 信號後讀取第一次渲染好的結果(視頻控制器的指針指向第一個幀緩衝區),並同時渲染新的一幀圖像並將結果存入第二個幀緩衝區,等收到第三個 V-Sync 信號後,讀取第二個幀緩衝區的內容(視頻控制器的指針指向第二個幀緩衝區),並開始第三幀圖像的渲染並送入第一個幀緩衝區,依次不斷循環往復。
請查看資料:Multiple buffering
VSync 信號到來後,系統圖形服務會經過 CADisplayLink 等機制通知 App,App 主線程開始在 CPU 中計算顯示內容(視圖建立、佈局計算、圖片解碼、文本繪製等)。而後將計算的內容提交到 GPU,GPU 通過圖層的變換、合成、渲染,隨後 GPU 把渲染結果提交到幀緩衝區,等待下一次 VSync 信號到來再顯示以前渲染好的結果。在垂直同步機制的狀況下,若是在一個 VSync 時間週期內,CPU 或者 GPU 沒有完成內容的提交,就會形成該幀的丟棄,等待下一次機會再顯示,這時候屏幕上仍是以前渲染的圖像,因此這就是 CPU、GPU 層面界面卡頓的緣由。
目前 iOS 設備有雙緩存機制,也有三緩衝機制,Android 如今主流是三緩衝機制,在早期是單緩衝機制。
iOS 三緩衝機制例子
CPU 和 GPU 資源消耗緣由不少,好比對象的頻繁建立、屬性調整、文件讀取、視圖層級的調整、佈局的計算(AutoLayout 視圖個數多了就是線性方程求解難度變大)、圖片解碼(大圖的讀取優化)、圖像繪製、文本渲染、數據庫讀取(多讀仍是多寫樂觀鎖、悲觀鎖的場景)、鎖的使用(舉例:自旋鎖使用不當會浪費 CPU)等方面。開發者根據自身經驗尋找最優解(這裏不是本文重點)。
CADisplayLink 確定不用了,這個 FPS 僅做爲參考。通常來說,卡頓的監測有2種方案:監聽 RunLoop 狀態回調、子線程 ping 主線程
RunLoop 負責監聽輸入源進行調度處理。好比網絡、輸入設備、週期性或者延遲事件、異步回調等。RunLoop 會接收2種類型的輸入源:一種是來自另外一個線程或者來自不一樣應用的異步消息(source0事件)、另外一種是來自預約或者重複間隔的事件。
RunLoop 狀態以下圖
第一步:通知 Observers,RunLoop 要開始進入 loop,緊接着進入 loop
if (currentMode->_observerMask & kCFRunLoopEntry ) // 通知 Observers: RunLoop 即將進入 loop __CFRunLoopDoObservers(rl, currentMode, kCFRunLoopEntry); // 進入loop result = __CFRunLoopRun(rl, currentMode, seconds, returnAfterSourceHandled, previousMode);
第二步:開啓 do while 循環保活線程,通知 Observers,RunLoop 觸發 Timer 回調、Source0 回調,接着執行被加入的 block
if (rlm->_observerMask & kCFRunLoopBeforeTimers) // 通知 Observers: RunLoop 即將觸發 Timer 回調 __CFRunLoopDoObservers(rl, rlm, kCFRunLoopBeforeTimers); if (rlm->_observerMask & kCFRunLoopBeforeSources) // 通知 Observers: RunLoop 即將觸發 Source 回調 __CFRunLoopDoObservers(rl, rlm, kCFRunLoopBeforeSources); // 執行被加入的block __CFRunLoopDoBlocks(rl, rlm);
第三步:RunLoop 在觸發 Source0 回調後,若是 Source1 是 ready 狀態,就會跳轉到 handle_msg 去處理消息。
// 若是有 Source1 (基於port) 處於 ready 狀態,直接處理這個 Source1 而後跳轉去處理消息 if (MACH_PORT_NULL != dispatchPort && !didDispatchPortLastTime) { #if DEPLOYMENT_TARGET_MACOSX || DEPLOYMENT_TARGET_EMBEDDED || DEPLOYMENT_TARGET_EMBEDDED_MINI msg = (mach_msg_header_t *)msg_buffer; if (__CFRunLoopServiceMachPort(dispatchPort, &msg, sizeof(msg_buffer), &livePort, 0, &voucherState, NULL)) { goto handle_msg; } #elif DEPLOYMENT_TARGET_WINDOWS if (__CFRunLoopWaitForMultipleObjects(NULL, &dispatchPort, 0, 0, &livePort, NULL)) { goto handle_msg; } #endif }
第四步:回調觸發後,通知 Observers 即將進入休眠狀態
Boolean poll = sourceHandledThisLoop || (0ULL == timeout_context->termTSR); // 通知 Observers: RunLoop 的線程即將進入休眠(sleep) if (!poll && (rlm->_observerMask & kCFRunLoopBeforeWaiting)) __CFRunLoopDoObservers(rl, rlm, kCFRunLoopBeforeWaiting); __CFRunLoopSetSleeping(rl);
第五步:進入休眠後,會等待 mach_port 消息,以便再次喚醒。只有如下4種狀況才能夠被再次喚醒。
do { if (kCFUseCollectableAllocator) { // objc_clear_stack(0); // <rdar://problem/16393959> memset(msg_buffer, 0, sizeof(msg_buffer)); } msg = (mach_msg_header_t *)msg_buffer; __CFRunLoopServiceMachPort(waitSet, &msg, sizeof(msg_buffer), &livePort, poll ? 0 : TIMEOUT_INFINITY, &voucherState, &voucherCopy); if (modeQueuePort != MACH_PORT_NULL && livePort == modeQueuePort) { // Drain the internal queue. If one of the callout blocks sets the timerFired flag, break out and service the timer. while (_dispatch_runloop_root_queue_perform_4CF(rlm->_queue)); if (rlm->_timerFired) { // Leave livePort as the queue port, and service timers below rlm->_timerFired = false; break; } else { if (msg && msg != (mach_msg_header_t *)msg_buffer) free(msg); } } else { // Go ahead and leave the inner loop. break; } } while (1);
第六步:喚醒時通知 Observer,RunLoop 的線程剛剛被喚醒了
// 通知 Observers: RunLoop 的線程剛剛被喚醒了 if (!poll && (rlm->_observerMask & kCFRunLoopAfterWaiting)) __CFRunLoopDoObservers(rl, rlm, kCFRunLoopAfterWaiting); // 處理消息 handle_msg:; __CFRunLoopSetIgnoreWakeUps(rl);
第七步:RunLoop 喚醒後,處理喚醒時收到的消息
#if USE_MK_TIMER_TOO // 若是一個 Timer 到時間了,觸發這個Timer的回調 else if (rlm->_timerPort != MACH_PORT_NULL && livePort == rlm->_timerPort) { CFRUNLOOP_WAKEUP_FOR_TIMER(); // On Windows, we have observed an issue where the timer port is set before the time which we requested it to be set. For example, we set the fire time to be TSR 167646765860, but it is actually observed firing at TSR 167646764145, which is 1715 ticks early. The result is that, when __CFRunLoopDoTimers checks to see if any of the run loop timers should be firing, it appears to be 'too early' for the next timer, and no timers are handled. // In this case, the timer port has been automatically reset (since it was returned from MsgWaitForMultipleObjectsEx), and if we do not re-arm it, then no timers will ever be serviced again unless something adjusts the timer list (e.g. adding or removing timers). The fix for the issue is to reset the timer here if CFRunLoopDoTimers did not handle a timer itself. 9308754 if (!__CFRunLoopDoTimers(rl, rlm, mach_absolute_time())) { // Re-arm the next timer __CFArmNextTimerInMode(rlm, rl); } } #endif // 若是有dispatch到main_queue的block,執行block else if (livePort == dispatchPort) { CFRUNLOOP_WAKEUP_FOR_DISPATCH(); __CFRunLoopModeUnlock(rlm); __CFRunLoopUnlock(rl); _CFSetTSD(__CFTSDKeyIsInGCDMainQ, (void *)6, NULL); #if DEPLOYMENT_TARGET_WINDOWS void *msg = 0; #endif __CFRUNLOOP_IS_SERVICING_THE_MAIN_DISPATCH_QUEUE__(msg); _CFSetTSD(__CFTSDKeyIsInGCDMainQ, (void *)0, NULL); __CFRunLoopLock(rl); __CFRunLoopModeLock(rlm); sourceHandledThisLoop = true; didDispatchPortLastTime = true; } // 若是一個 Source1 (基於port) 發出事件了,處理這個事件 else { CFRUNLOOP_WAKEUP_FOR_SOURCE(); // If we received a voucher from this mach_msg, then put a copy of the new voucher into TSD. CFMachPortBoost will look in the TSD for the voucher. By using the value in the TSD we tie the CFMachPortBoost to this received mach_msg explicitly without a chance for anything in between the two pieces of code to set the voucher again. voucher_t previousVoucher = _CFSetTSD(__CFTSDKeyMachMessageHasVoucher, (void *)voucherCopy, os_release); CFRunLoopSourceRef rls = __CFRunLoopModeFindSourceForMachPort(rl, rlm, livePort); if (rls) { #if DEPLOYMENT_TARGET_MACOSX || DEPLOYMENT_TARGET_EMBEDDED || DEPLOYMENT_TARGET_EMBEDDED_MINI mach_msg_header_t *reply = NULL; sourceHandledThisLoop = __CFRunLoopDoSource1(rl, rlm, rls, msg, msg->msgh_size, &reply) || sourceHandledThisLoop; if (NULL != reply) { (void)mach_msg(reply, MACH_SEND_MSG, reply->msgh_size, 0, MACH_PORT_NULL, 0, MACH_PORT_NULL); CFAllocatorDeallocate(kCFAllocatorSystemDefault, reply); } #elif DEPLOYMENT_TARGET_WINDOWS sourceHandledThisLoop = __CFRunLoopDoSource1(rl, rlm, rls) || sourceHandledThisLoop; #endif
第八步:根據當前 RunLoop 狀態判斷是否須要進入下一個 loop。當被外部強制中止或者 loop 超時,就不繼續下一個 loop,不然進入下一個 loop
if (sourceHandledThisLoop && stopAfterHandle) { // 進入loop時參數說處理完事件就返回 retVal = kCFRunLoopRunHandledSource; } else if (timeout_context->termTSR < mach_absolute_time()) { // 超出傳入參數標記的超時時間了 retVal = kCFRunLoopRunTimedOut; } else if (__CFRunLoopIsStopped(rl)) { __CFRunLoopUnsetStopped(rl); // 被外部調用者強制中止了 retVal = kCFRunLoopRunStopped; } else if (rlm->_stopped) { rlm->_stopped = false; retVal = kCFRunLoopRunStopped; } else if (__CFRunLoopModeIsEmpty(rl, rlm, previousMode)) { // source/timer一個都沒有 retVal = kCFRunLoopRunFinished; }
完整且帶有註釋的 RunLoop 代碼見此處。 Source1 是 RunLoop 用來處理 Mach port 傳來的系統事件的,Source0 是用來處理用戶事件的。收到 Source1 的系統事件後本質仍是調用 Source0 事件的處理函數。
RunLoop 6個狀態
typedef CF_OPTIONS(CFOptionFlags, CFRunLoopActivity) { kCFRunLoopEntry , // 進入 loop kCFRunLoopBeforeTimers , // 觸發 Timer 回調 kCFRunLoopBeforeSources , // 觸發 Source0 回調 kCFRunLoopBeforeWaiting , // 等待 mach_port 消息 kCFRunLoopAfterWaiting ), // 接收 mach_port 消息 kCFRunLoopExit , // 退出 loop kCFRunLoopAllActivities // loop 全部狀態改變 }
RunLoop 在進入睡眠前的方法執行時間過長而致使沒法進入睡眠,或者線程喚醒後接收消息時間過長而沒法進入下一步,都會阻塞線程。若是是主線程,則表現爲卡頓。
一旦發現進入睡眠前的 KCFRunLoopBeforeSources 狀態,或者喚醒後 KCFRunLoopAfterWaiting,在設置的時間閾值內沒有變化,則可判斷爲卡頓,此時 dump 堆棧信息,還原案發現場,進而解決卡頓問題。
開啓一個子線程,不斷進行循環監測是否卡頓了。在 n 次都超過卡頓閾值後則認爲卡頓了。卡頓以後進行堆棧 dump 並上報(具備必定的機制,數據處理在下一 part 講)。
WatchDog 在不一樣狀態下具備不一樣的值。
卡頓閾值的設置的依據是 WatchDog 的機制。APM 系統裏面的閾值須要小於 WatchDog 的值,因此取值範圍在 [1, 6] 之間,業界一般選擇3秒。
經過 long dispatch_semaphore_wait(dispatch_semaphore_t dsema, dispatch_time_t timeout)
方法判斷是否阻塞主線程,Returns zero on success, or non-zero if the timeout occurred.
返回非0則表明超時阻塞了主線程。
可能不少人納悶 RunLoop 狀態那麼多,爲何選擇 KCFRunLoopBeforeSources 和 KCFRunLoopAfterWaiting?由於大部分卡頓都是在 KCFRunLoopBeforeSources 和 KCFRunLoopAfterWaiting 之間。好比 Source0 類型的 App 內部事件等
Runloop 檢測卡頓流程圖以下:
關鍵代碼以下:
// 設置Runloop observer的運行環境 CFRunLoopObserverContext context = {0, (__bridge void *)self, NULL, NULL}; // 建立Runloop observer對象 _observer = CFRunLoopObserverCreate(kCFAllocatorDefault, kCFRunLoopAllActivities, YES, 0, &runLoopObserverCallBack, &context); // 將新建的observer加入到當前thread的runloop CFRunLoopAddObserver(CFRunLoopGetMain(), _observer, kCFRunLoopCommonModes); // 建立信號 _semaphore = dispatch_semaphore_create(0); __weak __typeof(self) weakSelf = self; // 在子線程監控時長 dispatch_async(dispatch_get_global_queue(0, 0), ^{ __strong __typeof(weakSelf) strongSelf = weakSelf; if (!strongSelf) { return; } while (YES) { if (strongSelf.isCancel) { return; } // N次卡頓超過閾值T記錄爲一次卡頓 long semaphoreWait = dispatch_semaphore_wait(self->_semaphore, dispatch_time(DISPATCH_TIME_NOW, strongSelf.limitMillisecond * NSEC_PER_MSEC)); if (semaphoreWait != 0) { if (self->_activity == kCFRunLoopBeforeSources || self->_activity == kCFRunLoopAfterWaiting) { if (++strongSelf.countTime < strongSelf.standstillCount){ continue; } // 堆棧信息 dump 並結合數據上報機制,按照必定策略上傳數據到服務器。堆棧 dump 會在下面講解。數據上報會在 [打造功能強大、靈活可配置的數據上報組件](https://github.com/FantasticLBP/knowledge-kit/blob/master/Chapter1%20-%20iOS/1.80.md) 講 } } strongSelf.countTime = 0; } });
開啓一個子線程,建立一個初始值爲0的信號量、一個初始值爲 YES 的布爾值類型標誌位。將設置標誌位爲 NO 的任務派發到主線程中去,子線程休眠閾值時間,時間到後判斷標誌位是否被主線程成功(值爲 NO),若是沒成功則認爲豬線程發生了卡頓狀況,此時 dump 堆棧信息並結合數據上報機制,按照必定策略上傳數據到服務器。數據上報會在 打造功能強大、靈活可配置的數據上報組件 講
while (self.isCancelled == NO) { @autoreleasepool { __block BOOL isMainThreadNoRespond = YES; dispatch_semaphore_t semaphore = dispatch_semaphore_create(0); dispatch_async(dispatch_get_main_queue(), ^{ isMainThreadNoRespond = NO; dispatch_semaphore_signal(semaphore); }); [NSThread sleepForTimeInterval:self.threshold]; if (isMainThreadNoRespond) { if (self.handlerBlock) { self.handlerBlock(); // 外部在 block 內部 dump 堆棧(下面會講),數據上報 } } dispatch_semaphore_wait(semaphore, DISPATCH_TIME_FOREVER); } }
方法堆棧的獲取是一個麻煩事。理一下思路。[NSThread callStackSymbols]
能夠獲取當前線程的調用棧。可是當監控到卡頓發生,須要拿到主線程的堆棧信息就無能爲力了。從任何線程回到主線程這條路走不通。先作個知識回顧。
在計算機科學中,調用堆棧是一種棧類型的數據結構,用於存儲有關計算機程序的線程信息。這種棧也叫作執行堆棧、程序堆棧、控制堆棧、運行時堆棧、機器堆棧等。調用堆棧用於跟蹤每一個活動的子例程在完成執行後應該返回控制的點。
維基百科搜索到 「Call Stack」 的一張圖和例子,以下
上圖表示爲一個棧。分爲若干個棧幀(Frame),每一個棧幀對應一個函數調用。下面藍色部分表示 DrawSquare
函數,它在執行的過程當中調用了 DrawLine
函數,用綠色部分表示。
能夠看到棧幀由三部分組成:函數參數、返回地址、局部變量。好比在 DrawSquare 內部調用了 DrawLine 函數:第一先把 DrawLine 函數須要的參數入棧;第二把返回地址(控制信息。舉例:函數 A 內調用函數 B,調用函數B 的下一行代碼的地址就是返回地址)入棧;第三函數內部的局部變量也在該棧中存儲。
棧指針 Stack Pointer 表示當前棧的頂部,大多部分操做系統都是棧向下生長,因此棧指針是最小值。幀指針 Frame Pointer 指向的地址中,存儲了上一次 Stack Pointer 的值,也就是返回地址。
大多數操做系統中,每一個棧幀還保存了上一個棧幀的幀指針。所以知道當前棧幀的 Stack Pointer 和 Frame Pointer 就能夠不斷回溯,遞歸獲取棧底的幀。
接下來的步驟就是拿到全部線程的 Stack Pointer 和 Frame Pointer。而後不斷回溯,還原案發現場。
Mach task:
App 在運行的時候,會對應一個 Mach Task,而 Task 下可能有多條線程同時執行任務。《OS X and iOS Kernel Programming》 中描述 Mach Task 爲:任務(Task)是一種容器對象,虛擬內存空間和其餘資源都是經過這個容器對象管理的,這些資源包括設備和其餘句柄。簡單歸納爲:Mack task 是一個機器無關的 thread 的執行環境抽象。
做用: task 能夠理解爲一個進程,包含它的線程列表。
結構體:task_threads,將 target_task 任務下的全部線程保存在 act_list 數組中,數組個數爲 act_listCnt
kern_return_t task_threads ( task_t traget_task, thread_act_array_t *act_list, //線程指針列表 mach_msg_type_number_t *act_listCnt //線程個數 )
thread_info:
kern_return_t thread_info ( thread_act_t target_act, thread_flavor_t flavor, thread_info_t thread_info_out, mach_msg_type_number_t *thread_info_outCnt );
如何獲取線程的堆棧數據:
系統方法 kern_return_t task_threads(task_inspect_t target_task, thread_act_array_t *act_list, mach_msg_type_number_t *act_listCnt);
能夠獲取到全部的線程,不過這種方法獲取到的線程信息是最底層的 mach 線程。
對於每一個線程,能夠用 kern_return_t thread_get_state(thread_act_t target_act, thread_state_flavor_t flavor, thread_state_t old_state, mach_msg_type_number_t *old_stateCnt);
方法獲取它的全部信息,信息填充在 _STRUCT_MCONTEXT
類型的參數中,這個方法中有2個參數隨着 CPU 架構不一樣而不一樣。因此須要定義宏屏蔽不一樣 CPU 之間的區別。
_STRUCT_MCONTEXT
結構體中,存儲了當前線程的 Stack Pointer 和最頂部棧幀的 Frame pointer,進而回溯整個線程調用堆棧。
可是上述方法拿到的是內核線程,咱們須要的信息是 NSThread,因此須要將內核線程轉換爲 NSThread。
pthread 的 p 是 POSIX 的縮寫,表示「可移植操做系統接口」(Portable Operating System Interface)。設計初衷是每一個系統都有本身獨特的線程模型,且不一樣系統對於線程操做的 API 都不同。因此 POSIX 的目的就是提供抽象的 pthread 以及相關 API。這些 API 在不一樣的操做系統中有不一樣的實現,可是完成的功能一致。
Unix 系統提供的 task_threads
和 thread_get_state
操做的都是內核系統,每一個內核線程由 thread_t 類型的 id 惟一標識。pthread 的惟一標識是 pthread_t 類型。其中內核線程和 pthread 的轉換(即 thread_t 和 pthread_t)很容易,由於 pthread 設計初衷就是「抽象內核線程」。
memorystatus_action_neededpthread_create
方法建立線程的回調函數爲 nsthreadLauncher。
static void *nsthreadLauncher(void* thread) { NSThread *t = (NSThread*)thread; [nc postNotificationName: NSThreadDidStartNotification object:t userInfo: nil]; [t _setName: [t name]]; [t main]; [NSThread exit]; return NULL; }
NSThreadDidStartNotification 其實就是字符串 @"_NSThreadDidStartNotification"。
<NSThread: 0x...>{number = 1, name = main}
爲了 NSThread 和內核線程對應起來,只能經過 name 一一對應。 pthread 的 API pthread_getname_np
也可獲取內核線程名字。np 表明 not POSIX,因此不能跨平臺使用。
思路歸納爲:將 NSThread 的原始名字存儲起來,再將名字改成某個隨機數(時間戳),而後遍歷內核線程 pthread 的名字,名字匹配則 NSThread 和內核線程對應了起來。找到後將線程的名字還原成本來的名字。對於主線程,因爲不能使用 pthread_getname_np
,因此在當前代碼的 load 方法中獲取到 thread_t,而後匹配名字。
static mach_port_t main_thread_id; + (void)load { main_thread_id = mach_thread_self(); }
應用啓動時間是影響用戶體驗的重要因素之一,因此咱們須要量化去衡量一個 App 的啓動速度到底有多快。啓動分爲冷啓動和熱啓動。
冷啓動:App 還沒有運行,必須加載並構建整個應用。完成應用的初始化。冷啓動存在較大優化空間。冷啓動時間從 application: didFinishLaunchingWithOptions:
方法開始計算,App 通常在這裏進行各類 SDK 和 App 的基礎初始化工做。
熱啓動:應用已經在後臺運行(常見場景:好比用戶使用 App 過程當中點擊 Home 鍵,再打開 App),因爲某些事件將應用喚醒到前臺,App 會在 applicationWillEnterForeground:
方法接受應用進入前臺的事件
思路比較簡單。以下
load
方法中先拿到當前的時間值UIApplicationDidFinishLaunchingNotification
mach_absolute_time
是一個 CPU/總線依賴函數,返回一個 CPU 時鐘週期數。系統休眠時不會增長。是一個納秒級別的數字。獲取先後2個納秒後須要轉換到秒。須要基於系統時間的基準,經過 mach_timebase_info
得到。
mach_timebase_info_data_t g_cmmStartupMonitorTimebaseInfoData = 0; mach_timebase_info(&g_cmmStartupMonitorTimebaseInfoData); uint64_t timelapse = mach_absolute_time() - g_cmmLoadTime; double timeSpan = (timelapse * g_cmmStartupMonitorTimebaseInfoData.numer) / (g_cmmStartupMonitorTimebaseInfoData.denom * 1e9);
要優化啓動時間,就先得知道在啓動階段到底作了什麼事情,針對現狀做出方案。
pre-main 階段定義爲 App 開始啓動到系統調用 main 函數這個階段;main 階段定義爲 main 函數入口到主 UI 框架的 viewDidAppear。
App 啓動過程:
+load()
函數;執行聲明爲 __attribute_((constructor)) 的 c 函數;Pre-Main 階段
Main 階段
每一個動態庫的加載,dyld 須要
優化:
優化:
優化:
+initialize
代替 +load
優化手段:
有一個叫作FUI的開源項目能很好的分析出再也不使用的類,準確率很是高,惟一的問題是它處理不了動態庫和靜態庫裏提供的類,也處理不了C++的類模板
因仍是 Object-c 的動態特性,由於須要經過類/方法名反射找到這個類/方法進行調用,Object-c 對象模型會把類/方法名字符串都保存下來;
壓縮圖片爲何能加快啓動速度呢?由於啓動的時候大大小小的圖片加載個十來二十個是很正常的,
圖片小了,IO操做量就小了,啓動固然就會快了,比較靠譜的壓縮算法是 TinyPNG。
CPU(Central Processing Unit)中央處理器,市場上主流的架構有 ARM(arm64)、Intel(x86)、AMD 等。其中 Intel 使用 CISC(Complex Instruction Set Computer),ARM 使用 RISC(Reduced Instruction Set Computer)。區別在於不一樣的 CPU 設計理念和方法。
早期 CPU 所有是 CISC 架構,設計目的是用最少的機器語言指令來完成所需的計算任務。好比對於乘法運算,在 CISC 架構的 CPU 上。一條指令 MUL ADDRA, ADDRB
就能夠將內存 ADDRA 和內存 ADDRB 中的數香乘,並將結果存儲在 ADDRA 中。作的事情就是:將 ADDRA、ADDRB 中的數據讀入到寄存器,相乘的結果寫入到內存的操做依賴於 CPU 設計,因此 CISC 架構會增長 CPU 的複雜性和對 CPU 工藝的要求。
RISC 架構要求軟件來指定各個操做步驟。好比上面的乘法,指令實現爲 MOVE A, ADDRA; MOVE B, ADDRB; MUL A, B; STR ADDRA, A;
。這種架構能夠下降 CPU 的複雜性以及容許在一樣的工藝水平下生產出功能更增強大的 CPU,可是對於編譯器的設計要求更高。
目前市場是大部分的 iPhone 都是基於 arm64 架構的。且 arm 架構能耗低。
講完了區別來說下如何作 CPU 使用率的監控
線程信息結構體
struct thread_basic_info { time_value_t user_time; /* user run time(用戶運行時長) */ time_value_t system_time; /* system run time(系統運行時長) */ integer_t cpu_usage; /* scaled cpu usage percentage(CPU使用率,上限1000) */ policy_t policy; /* scheduling policy in effect(有效調度策略) */ integer_t run_state; /* run state (運行狀態,見下) */ integer_t flags; /* various flags (各類各樣的標記) */ integer_t suspend_count; /* suspend count for thread(線程掛起次數) */ integer_t sleep_time; /* number of seconds that thread * has been sleeping(休眠時間) */ };
代碼在講堆棧還原的時候講過,忘記的看一下上面的分析
thread_act_array_t threads; mach_msg_type_number_t threadCount = 0; const task_t thisTask = mach_task_self(); kern_return_t kr = task_threads(thisTask, &threads, &threadCount); if (kr != KERN_SUCCESS) { return ; } for (int i = 0; i < threadCount; i++) { thread_info_data_t threadInfo; thread_basic_info_t threadBaseInfo; mach_msg_type_number_t threadInfoCount; kern_return_t kr = thread_info((thread_inspect_t)threads[i], THREAD_BASIC_INFO, (thread_info_t)threadInfo, &threadInfoCount); if (kr == KERN_SUCCESS) { threadBaseInfo = (thread_basic_info_t)threadInfo; // todo:條件判斷,看不明白 if (!(threadBaseInfo->flags & TH_FLAGS_IDLE)) { integer_t cpuUsage = threadBaseInfo->cpu_usage / 10; if (cpuUsage > CPUMONITORRATE) { NSMutableDictionary *CPUMetaDictionary = [NSMutableDictionary dictionary]; NSData *CPUPayloadData = [NSData data]; NSString *backtraceOfAllThread = [BacktraceLogger backtraceOfAllThread]; // 1. 組裝卡頓的 Meta 信息 CPUMetaDictionary[@"MONITOR_TYPE"] = CMMonitorCPUType; // 2. 組裝卡頓的 Payload 信息(一個JSON對象,對象的 Key 爲約定好的 STACK_TRACE, value 爲 base64 後的堆棧信息) NSData *CPUData = [SAFE_STRING(backtraceOfAllThread) dataUsingEncoding:NSUTF8StringEncoding]; NSString *CPUDataBase64String = [CPUData base64EncodedStringWithOptions:0]; NSDictionary *CPUPayloadDictionary = @{@"STACK_TRACE": SAFE_STRING(CPUDataBase64String)}; NSError *error; // NSJSONWritingOptions 參數必定要傳0,由於服務端須要根據 \n 處理邏輯,傳遞 0 則生成的 json 串不帶 \n NSData *parsedData = [NSJSONSerialization dataWithJSONObject:CPUPayloadDictionary options:0 error:&error]; if (error) { CMMLog(@"%@", error); return; } CPUPayloadData = [parsedData copy]; // 3. 數據上報會在 [打造功能強大、靈活可配置的數據上報組件](https://github.com/FantasticLBP/knowledge-kit/blob/master/Chapter1%20-%20iOS/1.80.md) 講 [[PrismClient sharedInstance] sendWithType:CMMonitorCPUType meta:CPUMetaDictionary payload:CPUPayloadData]; } } } }
硬盤:也叫作磁盤,用於存儲數據。你存儲的歌曲、圖片、視頻都是在硬盤裏。
內存:因爲硬盤讀取速度較慢,若是 CPU 運行程序期間,全部的數據都直接從硬盤中讀取,則很是影響效率。因此 CPU 會將程序運行所須要的數據從硬盤中讀取到內存中。而後 CPU 與內存中的數據進行計算、交換。內存是易失性存儲器(斷電後,數據消失)。內存條區是計算機內部(在主板上)的一些存儲器,用來保存 CPU 運算的中間數據和結果。內存是程序與 CPU 之間的橋樑。從硬盤讀取出數據或者運行程序提供給 CPU。
虛擬內存 是計算機系統內存管理的一種技術。它使得程序認爲它擁有連續的可用內存,而實際上,它一般被分割成多個物理內存碎片,可能部分暫時存儲在外部磁盤(硬盤)存儲器上(當須要使用時則用硬盤中數據交換到內存中)。Windows 系統中稱爲 「虛擬內存」,Linux/Unix 系統中稱爲 」交換空間「。
iOS 不支持交換空間?不僅是 iOS 不支持交換空間,大多數手機系統都不支持。由於移動設備的大量存儲器是閃存,它的讀寫速度遠遠小電腦所使用的硬盤,也就是說手機即便使用了交換空間技術,也由於閃存慢的問題,不能提高性能,因此索性就沒有交換空間技術。
內存(RAM)與 CPU 同樣都是系統中最稀少的資源,也很容易發生競爭,應用內存與性能直接相關。iOS 沒有交換空間做爲備選資源,因此內存資源尤其重要。
什麼是 OOM?是 out-of-memory 的縮寫,字面意思是超過了內存限制。分爲 FOOM(foreground OOM)和 BOOM(background OOM)。它是由 iOS 的 Jetsam
機制形成的一種非主流 Crash,它不能經過 Signal 這種監控方案所捕獲。
什麼是 Jetsam 機制?Jetsam 機制能夠理解爲系統爲了控制內存資源過分使用而採用的一種管理機制。Jetsam 機制是運行在一個獨立的進程中,每一個進程都有一個內存閾值,一旦超過這個內存閾值,Jetsam 會當即殺掉這個進程。
爲何設計 Jetsam 機制?由於設備的內存是有限的,因此內存資源很是重要。系統進程以及其餘使用的 App 都會搶佔這個資源。因爲 iOS 不支持交換空間,一旦觸發低內存事件,Jetsam 就會盡量多的釋放 App 所在內存,這樣 iOS 系統上出現內存不足時,App 就會被系統殺掉,變現爲 crash。
2種狀況觸發 OOM:系統因爲總體內存使用太高,會基於優先級策略殺死優先級較低的 App;當前 App 達到了 "highg water mark" ,系統也會強殺當前 App(超過系統對當前單個 App 的內存限制值)。
讀了源碼(xnu/bsd/kern/kern_memorystatus.c)會發現內存被殺也有2種機制,以下
highwater 處理 -> 咱們的 App 佔用內存不能超過單個限制
memorystatus_act_aggressive 處理 -> 內存佔用高,按照優先級殺死
內存過大的幾種狀況
App 內存不足時,系統會按照必定策略來騰出更多的空間供使用。比較常見的作法是將一部分優先級低的數據挪到磁盤上,該操做爲稱爲 page out。以後再次訪問這塊數據的時候,系統會負責將它從新搬回到內存中,該操做被稱爲 page in。
Memory page** 是內存管理中的最小單位,是系統分配的,可能一個 page 持有多個對象,也可能一個大的對象跨越多個 page。一般它是 16KB 大小,且有3種類型的 page。
page out
的內存、內存映射文件、App 使用到的 framework(每一個 framework 都有 _DATA_CONST 段,一般都是 clean 狀態,但使用 runtime swizling,那麼變爲 dirty)。一開始分配的 page 都是乾淨的(堆裏面的對象分配除外),咱們 App 數據寫入時候變爲 dirty。從硬盤讀進內存的文件,也是隻讀的、clean page。
Dirty memory 包括4類:被 App 寫入過數據的內存、全部堆區分配的對象、圖像解碼緩衝區、framework(framework 都有 _DATA 段和 _DATA_DIRTY 段,它們的內存都是 dirty)。
在使用 framework 的過程當中會產生 Dirty memory,使用單例或者全局初始化方法有助於幫助減小 Dirty memory(由於單例一旦建立就不銷燬,一直在內存中,系統不認爲是 Dirty memory)。
因爲閃存容量和讀寫限制,iOS 沒有交換空間機制,而是在 iOS7 引入了 memory compressor。它是在內存緊張時候可以將最近一段時間未使用過的內存對象,內存壓縮器會把對象壓縮,釋放出更多的 page。在須要時內存壓縮器對其解壓複用。在節省內存的同時提升了響應速度。
好比 App 使用某 Framework,內部有個 NSDictionary 屬性存儲數據,使用了 3 pages 內存,在近期未被訪問的時候 memory compressor 將其壓縮爲 1 page,再次使用的時候還原爲 3 pages。
App 運行內存 = pageNumbers * pageSize。由於 Compressed Memory 屬於 Dirty memory。因此 Memory footprint = dirtySize + CompressedSize
設備不一樣,內存佔用上限不一樣,App 上限較高,extension 上限較低,超過上限 crash 到 EXC_RESOURCE_EXCEPTION
。
接下來談一下如何獲取內存上限,以及如何監控 App 由於佔用內存過大而被強殺。
當 App 被 Jetsam 機制殺死時,手機會生成系統日誌。查看路徑:Settings-Privacy-Analytics & Improvements- Analytics Data(設置-隱私- 分析與改進-分析數據),能夠看到 JetsamEvent-2020-03-14-161828.ips
形式的日誌,以 JetsamEvent 開頭。這些 JetsamEvent 日誌都是 iOS 系統內核強殺掉那些優先級不高(idle、frontmost、suspended)且佔用內存超過系統內存限制的 App 留下的。
日誌包含了 App 的內存信息。能夠查看到 日誌最頂部有 pageSize
字段,查找到 per-process-limit,該節點所在結構裏的 rpages
,將 rpages * pageSize 便可獲得 OOM 的閾值。
日誌中 largestProcess 字段表明 App 名稱;reason 字段表明內存緣由;states 字段表明奔潰時 App 的狀態( idle、suspended、frontmost...)。
爲了測試數據的準確性,我將測試2臺設備(iPhone 6s plus/13.3.1,iPhone 11 Pro/13.3.1)的全部 App 完全退出,只跑了一個爲了測試內存臨界值的 Demo App。 循環申請內存,ViewController 代碼以下
- (void)viewDidLoad { [super viewDidLoad]; NSMutableArray *array = [NSMutableArray array]; for (NSInteger index = 0; index < 10000000; index++) { UIImageView *imageView = [[UIImageView alloc] initWithFrame:CGRectMake(0, 0, 100, 100)]; UIImage *image = [UIImage imageNamed:@"AppIcon"]; imageView.image = image; [array addObject:imageView]; } }
iPhone 6s plus/13.3.1 數據以下:
{"bug_type":"298","timestamp":"2020-03-19 17:23:45.94 +0800","os_version":"iPhone OS 13.3.1 (17D50)","incident_id":"DA8AF66D-24E8-458C-8734-981866942168"} { "crashReporterKey" : "fc9b659ce486df1ed1b8062d5c7c977a7eb8c851", "kernel" : "Darwin Kernel Version 19.3.0: Thu Jan 9 21:10:44 PST 2020; root:xnu-6153.82.3~1\/RELEASE_ARM64_S8000", "product" : "iPhone8,2", "incident" : "DA8AF66D-24E8-458C-8734-981866942168", "date" : "2020-03-19 17:23:45.93 +0800", "build" : "iPhone OS 13.3.1 (17D50)", "timeDelta" : 332, "memoryStatus" : { "compressorSize" : 48499, "compressions" : 7458651, "decompressions" : 5190200, "zoneMapCap" : 744407040, "largestZone" : "APFS_4K_OBJS", "largestZoneSize" : 41402368, "pageSize" : 16384, "uncompressed" : 104065, "zoneMapSize" : 141606912, "memoryPages" : { "active" : 26214, "throttled" : 0, "fileBacked" : 14903, "wired" : 20019, "anonymous" : 37140, "purgeable" : 142, "inactive" : 23669, "free" : 2967, "speculative" : 2160 } }, "largestProcess" : "Test", "genCounter" : 0, "processes" : [ { "uuid" : "39c5738b-b321-3865-a731-68064c4f7a6f", "states" : [ "daemon", "idle" ], "lifetimeMax" : 188, "age" : 948223699030, "purgeable" : 0, "fds" : 25, "coalition" : 422, "rpages" : 177, "pid" : 282, "idleDelta" : 824711280, "name" : "com.apple.Safari.SafeBrowsing.Se", "cpuTime" : 10.275422000000001 }, // ... { "uuid" : "83dbf121-7c0c-3ab5-9b66-77ee926e1561", "states" : [ "frontmost" ], "killDelta" : 2592, "genCount" : 0, "age" : 1531004794, "purgeable" : 0, "fds" : 50, "coalition" : 1047, "rpages" : 92806, "reason" : "per-process-limit", "pid" : 2384, "cpuTime" : 59.464373999999999, "name" : "Test", "lifetimeMax" : 92806 }, // ... ] }
iPhone 6s plus/13.3.1 手機 OOM 臨界值爲:(16384*92806)/(1024*1024)=1450.09375M
iPhone 11 Pro/13.3.1 數據以下:
{"bug_type":"298","timestamp":"2020-03-19 17:30:28.39 +0800","os_version":"iPhone OS 13.3.1 (17D50)","incident_id":"7F111601-BC7A-4BD7-A468-CE3370053057"} { "crashReporterKey" : "bc2445adc164c399b330f812a48248e029e26276", "kernel" : "Darwin Kernel Version 19.3.0: Thu Jan 9 21:11:10 PST 2020; root:xnu-6153.82.3~1\/RELEASE_ARM64_T8030", "product" : "iPhone12,3", "incident" : "7F111601-BC7A-4BD7-A468-CE3370053057", "date" : "2020-03-19 17:30:28.39 +0800", "build" : "iPhone OS 13.3.1 (17D50)", "timeDelta" : 189, "memoryStatus" : { "compressorSize" : 66443, "compressions" : 25498129, "decompressions" : 15532621, "zoneMapCap" : 1395015680, "largestZone" : "APFS_4K_OBJS", "largestZoneSize" : 41222144, "pageSize" : 16384, "uncompressed" : 127027, "zoneMapSize" : 169639936, "memoryPages" : { "active" : 58652, "throttled" : 0, "fileBacked" : 20291, "wired" : 45838, "anonymous" : 96445, "purgeable" : 4, "inactive" : 54368, "free" : 5461, "speculative" : 3716 } }, "largestProcess" : "杭城小劉", "genCounter" : 0, "processes" : [ { "uuid" : "2dd5eb1e-fd31-36c2-99d9-bcbff44efbb7", "states" : [ "daemon", "idle" ], "lifetimeMax" : 171, "age" : 5151034269954, "purgeable" : 0, "fds" : 50, "coalition" : 66, "rpages" : 164, "pid" : 11276, "idleDelta" : 3801132318, "name" : "wcd", "cpuTime" : 3.430787 }, // ... { "uuid" : "63158edc-915f-3a2b-975c-0e0ac4ed44c0", "states" : [ "frontmost" ], "killDelta" : 4345, "genCount" : 0, "age" : 654480778, "purgeable" : 0, "fds" : 50, "coalition" : 1718, "rpages" : 134278, "reason" : "per-process-limit", "pid" : 14206, "cpuTime" : 23.955463999999999, "name" : "杭城小劉", "lifetimeMax" : 134278 }, // ... ] }
iPhone 11 Pro/13.3.1 手機 OOM 臨界值爲:(16384*134278)/(1024*1024)=2098.09375M
iOS 系統如何發現 Jetsam ?
MacOS/iOS 是一個 BSD 衍生而來的系統,其內核是 Mach,可是對於上層暴露的接口通常是基於 BSD 層對 Mach 的包裝後的。Mach 是一個微內核的架構,真正的虛擬內存管理也是在其中進行的,BSD 對內存管理提供了上層接口。Jetsam 事件也是由 BSD 產生的。bsd_init
函數是入口,其中基本都是在初始化各個子系統,好比虛擬內存管理等。
// 1. Initialize the kernel memory allocator, 初始化 BSD 內存 Zone,這個 Zone 是基於 Mach 內核的zone 構建 kmeminit(); // 2. Initialise background freezing, iOS 上獨有的特性,內存和進程的休眠的常駐監控線程 #if CONFIG_FREEZE #ifndef CONFIG_MEMORYSTATUS #error "CONFIG_FREEZE defined without matching CONFIG_MEMORYSTATUS" #endif /* Initialise background freezing */ bsd_init_kprintf("calling memorystatus_freeze_init\n"); memorystatus_freeze_init(); #endif> // 3. iOS 獨有,JetSAM(即低內存事件的常駐監控線程) #if CONFIG_MEMORYSTATUS /* Initialize kernel memory status notifications */ bsd_init_kprintf("calling memorystatus_init\n"); memorystatus_init(); #endif /* CONFIG_MEMORYSTATUS */
主要做用就是開啓了2個優先級最高的線程,來監控整個系統的內存狀況。
CONFIG_FREEZE 開啓時,內核對進程進行冷凍而不是殺死。冷凍功能是由內核中啓動一個 memorystatus_freeze_thread
進行,這個進程在收到信號後調用 memorystatus_freeze_top_process
進行冷凍。
iOS 系統會開啓優先級最高的線程 vm_pressure_monitor
來監控系統的內存壓力狀況,並經過一個堆棧來維護全部 App 進程。iOS 系統還會維護一個內存快照表,用於保存每一個進程內存頁的消耗狀況。有關 Jetsam 也就是 memorystatus 相關的邏輯,能夠在 XNU 項目中的 kern_memorystatus.h 和 kern_memorystatus.c 源碼中查看。
iOS 系統因內存佔用太高會強殺 App 前,至少有 6秒鐘能夠用來作優先級判斷,JetsamEvent 日誌也是在這6秒內生成的。
上文提到了 iOS 系統沒有交換空間,因而引入了 MemoryStatus 機制(也稱爲 Jetsam)。也就是說在 iOS 系統上釋放盡量多的內存供當前 App 使用。這個機制表如今優先級上,就是先強殺後臺應用;若是內存仍是不夠多,就強殺掉當前應用。在 MacOS 中,MemoryStatus 只會強殺掉標記爲空閒退出的進程。
MemoryStatus 機制會開啓一個 memorystatus_jetsam_thread 的線程,它負責強殺 App 和記錄日誌,不會發送消息,因此內存壓力檢測線程沒法獲取到強殺 App 的消息。
當監控線程發現某 App 有內存壓力時,就發出通知,此時有內存的 App 就去執行 didReceiveMemoryWarning
代理方法。在這個時機,咱們還有機會作一些內存資源釋放的邏輯,也許會避免 App 被系統殺死。
源碼角度查看問題
iOS 系統內核有一個數組,專門維護線程的優先級。數組的每一項是一個包含進程鏈表的結構體。結構體以下:
#define MEMSTAT_BUCKET_COUNT (JETSAM_PRIORITY_MAX + 1) typedef struct memstat_bucket { TAILQ_HEAD(, proc) list; int count; } memstat_bucket_t; memstat_bucket_t memstat_bucket[MEMSTAT_BUCKET_COUNT];
在 kern_memorystatus.h 中能夠看到進行優先級信息
#define JETSAM_PRIORITY_IDLE_HEAD -2 /* The value -1 is an alias to JETSAM_PRIORITY_DEFAULT */ #define JETSAM_PRIORITY_IDLE 0 #define JETSAM_PRIORITY_IDLE_DEFERRED 1 /* Keeping this around till all xnu_quick_tests can be moved away from it.*/ #define JETSAM_PRIORITY_AGING_BAND1 JETSAM_PRIORITY_IDLE_DEFERRED #define JETSAM_PRIORITY_BACKGROUND_OPPORTUNISTIC 2 #define JETSAM_PRIORITY_AGING_BAND2 JETSAM_PRIORITY_BACKGROUND_OPPORTUNISTIC #define JETSAM_PRIORITY_BACKGROUND 3 #define JETSAM_PRIORITY_ELEVATED_INACTIVE JETSAM_PRIORITY_BACKGROUND #define JETSAM_PRIORITY_MAIL 4 #define JETSAM_PRIORITY_PHONE 5 #define JETSAM_PRIORITY_UI_SUPPORT 8 #define JETSAM_PRIORITY_FOREGROUND_SUPPORT 9 #define JETSAM_PRIORITY_FOREGROUND 10 #define JETSAM_PRIORITY_AUDIO_AND_ACCESSORY 12 #define JETSAM_PRIORITY_CONDUCTOR 13 #define JETSAM_PRIORITY_HOME 16 #define JETSAM_PRIORITY_EXECUTIVE 17 #define JETSAM_PRIORITY_IMPORTANT 18 #define JETSAM_PRIORITY_CRITICAL 19 #define JETSAM_PRIORITY_MAX 21
能夠明顯的看到,後臺 App 優先級 JETSAM_PRIORITY_BACKGROUND 爲3,前臺 App 優先級 JETSAM_PRIORITY_FOREGROUND 爲10。
優先級規則是:內核線程優先級 > 操做系統優先級 > App 優先級。且前臺 App 優先級高於後臺運行的 App;當線程的優先級相同時, CPU 佔用多的線程的優先級會被下降。
在 kern_memorystatus.c 中能夠看到 OOM 可能的緣由:
/* For logging clarity */ static const char *memorystatus_kill_cause_name[] = { "" , /* kMemorystatusInvalid */ "jettisoned" , /* kMemorystatusKilled */ "highwater" , /* kMemorystatusKilledHiwat */ "vnode-limit" , /* kMemorystatusKilledVnodes */ "vm-pageshortage" , /* kMemorystatusKilledVMPageShortage */ "proc-thrashing" , /* kMemorystatusKilledProcThrashing */ "fc-thrashing" , /* kMemorystatusKilledFCThrashing */ "per-process-limit" , /* kMemorystatusKilledPerProcessLimit */ "disk-space-shortage" , /* kMemorystatusKilledDiskSpaceShortage */ "idle-exit" , /* kMemorystatusKilledIdleExit */ "zone-map-exhaustion" , /* kMemorystatusKilledZoneMapExhaustion */ "vm-compressor-thrashing" , /* kMemorystatusKilledVMCompressorThrashing */ "vm-compressor-space-shortage" , /* kMemorystatusKilledVMCompressorSpaceShortage */ };
查看 memorystatus_init 這個函數中初始化 Jetsam 線程的關鍵代碼
__private_extern__ void memorystatus_init(void) { // ... /* Initialize the jetsam_threads state array */ jetsam_threads = kalloc(sizeof(struct jetsam_thread_state) * max_jetsam_threads); /* Initialize all the jetsam threads */ for (i = 0; i < max_jetsam_threads; i++) { result = kernel_thread_start_priority(memorystatus_thread, NULL, 95 /* MAXPRI_KERNEL */, &jetsam_threads[i].thread); if (result == KERN_SUCCESS) { jetsam_threads[i].inited = FALSE; jetsam_threads[i].index = i; thread_deallocate(jetsam_threads[i].thread); } else { panic("Could not create memorystatus_thread %d", i); } } }
/* * High-level priority assignments * ************************************************************************* * 127 Reserved (real-time) * A * + * (32 levels) * + * V * 96 Reserved (real-time) * 95 Kernel mode only * A * + * (16 levels) * + * V * 80 Kernel mode only * 79 System high priority * A * + * (16 levels) * + * V * 64 System high priority * 63 Elevated priorities * A * + * (12 levels) * + * V * 52 Elevated priorities * 51 Elevated priorities (incl. BSD +nice) * A * + * (20 levels) * + * V * 32 Elevated priorities (incl. BSD +nice) * 31 Default (default base for threads) * 30 Lowered priorities (incl. BSD -nice) * A * + * (20 levels) * + * V * 11 Lowered priorities (incl. BSD -nice) * 10 Lowered priorities (aged pri's) * A * + * (11 levels) * + * V * 0 Lowered priorities (aged pri's / idle) ************************************************************************* */
能夠看出:用戶態的應用程序的線程不可能高於操做系統和內核。並且,用戶態的應用程序間的線程優先級分配也有區別,好比處於前臺的應用程序優先級高於處於後臺的應用程序優先級。iOS 上應用程序優先級最高的是 SpringBoard;此外線程的優先級不是一成不變的。Mach 會根據線程的利用率和系統總體負載動態調整線程優先級。若是耗費 CPU 太多就下降線程優先級,若是線程過分捱餓,則會提高線程優先級。可是不管怎麼變,程序都不能超過其所在線程的優先級區間範圍。
能夠看出,系統會根據內核啓動參數和設備性能,開啓 max_jetsam_threads 個(通常狀況爲1,特殊狀況下可能爲3)jetsam 線程,且這些線程的優先級爲 95,也就是 MAXPRI_KERNEL(注意這裏的 95 是線程的優先級,XNU 的線程優先級區間爲:0~127。上文的宏定義是進程優先級,區間爲:-2~19)。
緊接着,分析下 memorystatus_thread 函數,主要負責線程啓動的初始化
static void memorystatus_thread(void *param __unused, wait_result_t wr __unused) { //... while (memorystatus_action_needed()) { boolean_t killed; int32_t priority; uint32_t cause; uint64_t jetsam_reason_code = JETSAM_REASON_INVALID; os_reason_t jetsam_reason = OS_REASON_NULL; cause = kill_under_pressure_cause; switch (cause) { case kMemorystatusKilledFCThrashing: jetsam_reason_code = JETSAM_REASON_MEMORY_FCTHRASHING; break; case kMemorystatusKilledVMCompressorThrashing: jetsam_reason_code = JETSAM_REASON_MEMORY_VMCOMPRESSOR_THRASHING; break; case kMemorystatusKilledVMCompressorSpaceShortage: jetsam_reason_code = JETSAM_REASON_MEMORY_VMCOMPRESSOR_SPACE_SHORTAGE; break; case kMemorystatusKilledZoneMapExhaustion: jetsam_reason_code = JETSAM_REASON_ZONE_MAP_EXHAUSTION; break; case kMemorystatusKilledVMPageShortage: /* falls through */ default: jetsam_reason_code = JETSAM_REASON_MEMORY_VMPAGESHORTAGE; cause = kMemorystatusKilledVMPageShortage; break; } /* Highwater */ boolean_t is_critical = TRUE; if (memorystatus_act_on_hiwat_processes(&errors, &hwm_kill, &post_snapshot, &is_critical)) { if (is_critical == FALSE) { /* * For now, don't kill any other processes. */ break; } else { goto done; } } jetsam_reason = os_reason_create(OS_REASON_JETSAM, jetsam_reason_code); if (jetsam_reason == OS_REASON_NULL) { printf("memorystatus_thread: failed to allocate jetsam reason\n"); } if (memorystatus_act_aggressive(cause, jetsam_reason, &jld_idle_kills, &corpse_list_purged, &post_snapshot)) { goto done; } /* * memorystatus_kill_top_process() drops a reference, * so take another one so we can continue to use this exit reason * even after it returns */ os_reason_ref(jetsam_reason); /* LRU */ killed = memorystatus_kill_top_process(TRUE, sort_flag, cause, jetsam_reason, &priority, &errors); sort_flag = FALSE; if (killed) { if (memorystatus_post_snapshot(priority, cause) == TRUE) { post_snapshot = TRUE; } /* Jetsam Loop Detection */ if (memorystatus_jld_enabled == TRUE) { if ((priority == JETSAM_PRIORITY_IDLE) || (priority == system_procs_aging_band) || (priority == applications_aging_band)) { jld_idle_kills++; } else { /* * We've reached into bands beyond idle deferred. * We make no attempt to monitor them */ } } if ((priority >= JETSAM_PRIORITY_UI_SUPPORT) && (total_corpses_count() > 0) && (corpse_list_purged == FALSE)) { /* * If we have jetsammed a process in or above JETSAM_PRIORITY_UI_SUPPORT * then we attempt to relieve pressure by purging corpse memory. */ task_purge_all_corpses(); corpse_list_purged = TRUE; } goto done; } if (memorystatus_avail_pages_below_critical()) { /* * Still under pressure and unable to kill a process - purge corpse memory */ if (total_corpses_count() > 0) { task_purge_all_corpses(); corpse_list_purged = TRUE; } if (memorystatus_avail_pages_below_critical()) { /* * Still under pressure and unable to kill a process - panic */ panic("memorystatus_jetsam_thread: no victim! available pages:%llu\n", (uint64_t)memorystatus_available_pages); } } done: }
能夠看到它開啓了一個 循環,memorystatus_action_needed() 來做爲循環條件,持續釋放內存。
static boolean_t memorystatus_action_needed(void) { #if CONFIG_EMBEDDED return (is_reason_thrashing(kill_under_pressure_cause) || is_reason_zone_map_exhaustion(kill_under_pressure_cause) || memorystatus_available_pages <= memorystatus_available_pages_pressure); #else /* CONFIG_EMBEDDED */ return (is_reason_thrashing(kill_under_pressure_cause) || is_reason_zone_map_exhaustion(kill_under_pressure_cause)); #endif /* CONFIG_EMBEDDED */ }
它經過 vm_pagepout 發送的內存壓力來判斷當前內存資源是否緊張。幾種狀況:頻繁的頁面換出換進 is_reason_thrashing, Mach Zone 耗盡了 is_reason_zone_map_exhaustion、以及可用的頁低於了 memory status_available_pages 這個門檻。
繼續看 memorystatus_thread,會發現內存緊張時,將先觸發 High-water 類型的 OOM,也就是說假如某個進程使用過程當中超過了其使用內存的最高限制 hight water mark 時會發生 OOM。在 memorystatus_act_on_hiwat_processes() 中,經過 memorystatus_kill_hiwat_proc() 在優先級數組 memstat_bucket 中查找優先級最低的進程,若是進程的內存小於閾值(footprint_in_bytes <= memlimit_in_bytes)則繼續尋找次優先級較低的進程,直到找到佔用內存超過閾值的進程並殺死。
一般來講單個 App 很難觸碰到 high water mark,若是不能結束任何進程,最終走到 memorystatus_act_aggressive,也就是大多數 OOM 發生的地方。
static boolean_t memorystatus_act_aggressive(uint32_t cause, os_reason_t jetsam_reason, int *jld_idle_kills, boolean_t *corpse_list_purged, boolean_t *post_snapshot) { // ... if ( (jld_bucket_count == 0) || (jld_now_msecs > (jld_timestamp_msecs + memorystatus_jld_eval_period_msecs))) { /* * Refresh evaluation parameters */ jld_timestamp_msecs = jld_now_msecs; jld_idle_kill_candidates = jld_bucket_count; *jld_idle_kills = 0; jld_eval_aggressive_count = 0; jld_priority_band_max = JETSAM_PRIORITY_UI_SUPPORT; } //... }
上述代碼看到,判斷要不要真正執行 kill 是根據必定的時間間判斷的,條件是 jld_now_msecs > (jld_timestamp_msecs + memorystatus_jld_eval_period_msecs
。 也就是在 memorystatus_jld_eval_period_msecs 後才發生條件裏面的 kill。
/* Jetsam Loop Detection */ if (max_mem <= (512 * 1024 * 1024)) { /* 512 MB devices */ memorystatus_jld_eval_period_msecs = 8000; /* 8000 msecs == 8 second window */ } else { /* 1GB and larger devices */ memorystatus_jld_eval_period_msecs = 6000; /* 6000 msecs == 6 second window */ }
其中 memorystatus_jld_eval_period_msecs 取值最小6秒。因此咱們能夠在6秒內作些處理。
stackoverflow 上有一份數據,整理了各類設備的 OOM 臨界值
device | crash amount:MB | total amount:MB | percentage of total |
---|---|---|---|
iPad1 | 127 | 256 | 49% |
iPad2 | 275 | 512 | 53% |
iPad3 | 645 | 1024 | 62% |
iPad4(iOS 8.1) | 585 | 1024 | 57% |
Pad Mini 1st Generation | 297 | 512 | 58% |
iPad Mini retina(iOS 7.1) | 696 | 1024 | 68% |
iPad Air | 697 | 1024 | 68% |
iPad Air 2(iOS 10.2.1) | 1383 | 2048 | 68% |
iPad Pro 9.7"(iOS 10.0.2 (14A456)) | 1395 | 1971 | 71% |
iPad Pro 10.5」(iOS 11 beta4) | 3057 | 4000 | 76% |
iPad Pro 12.9」 (2015)(iOS 11.2.1) | 3058 | 3999 | 76% |
iPad 10.2(iOS 13.2.3) | 1844 | 2998 | 62% |
iPod touch 4th gen(iOS 6.1.1) | 130 | 256 | 51% |
iPod touch 5th gen | 286 | 512 | 56% |
iPhone4 | 325 | 512 | 63% |
iPhone4s | 286 | 512 | 56% |
iPhone5 | 645 | 1024 | 62% |
iPhone5s | 646 | 1024 | 63% |
iPhone6(iOS 8.x) | 645 | 1024 | 62% |
iPhone6 Plus(iOS 8.x) | 645 | 1024 | 62% |
iPhone6s(iOS 9.2) | 1396 | 2048 | 68% |
iPhone6s Plus(iOS 10.2.1) | 1396 | 2048 | 68% |
iPhoneSE(iOS 9.3) | 1395 | 2048 | 68% |
iPhone7(iOS 10.2) | 1395 | 2048 | 68% |
iPhone7 Plus(iOS 10.2.1) | 2040 | 3072 | 66% |
iPhone8(iOS 12.1) | 1364 | 1990 | 70% |
iPhoneX(iOS 11.2.1) | 1392 | 2785 | 50% |
iPhoneXS(iOS 12.1) | 2040 | 3754 | 54% |
iPhoneXS Max(iOS 12.1) | 2039 | 3735 | 55% |
iPhoneXR(iOS 12.1) | 1792 | 2813 | 63% |
iPhone11(iOS 13.1.3) | 2068 | 3844 | 54% |
iPhone11 Pro Max(iOS 13.2.3) | 2067 | 3740 | 55% |
咱們能夠寫定時器,不斷的申請內存,以後再經過 phys_footprint
打印當前佔用內存,按道理來講不斷申請內存便可觸發 Jetsam 機制,強殺 App,那麼最後一次打印的內存佔用也就是當前設備的內存上限值。
timer = [NSTimer scheduledTimerWithTimeInterval:0.01 target:self selector:@selector(allocateMemory) userInfo:nil repeats:YES]; - (void)allocateMemory { UIImageView *imageView = [[UIImageView alloc] initWithFrame:CGRectMake(0, 0, 100, 100)]; UIImage *image = [UIImage imageNamed:@"AppIcon"]; imageView.image = image; [array addObject:imageView]; memoryLimitSizeMB = [self usedSizeOfMemory]; if (memoryWarningSizeMB && memoryLimitSizeMB) { NSLog(@"----- memory warnning:%dMB, memory limit:%dMB", memoryWarningSizeMB, memoryLimitSizeMB); } } - (int)usedSizeOfMemory { task_vm_info_data_t taskInfo; mach_msg_type_number_t infoCount = TASK_VM_INFO_COUNT; kern_return_t kernReturn = task_info(mach_task_self(), TASK_VM_INFO, (task_info_t)&taskInfo, &infoCount); if (kernReturn != KERN_SUCCESS) { return 0; } return (int)(taskInfo.phys_footprint/1024.0/1024.0); }
iOS13 開始 <os/proc.h> 中 size_t os_proc_available_memory(void);
能夠查看當前可用內存。
Return ValueThe number of bytes that the app may allocate before it hits its memory limit. If the calling process isn't an app, or if the process has already exceeded its memory limit, this function returns
0
.Discussion
Call this function to determine the amount of memory available to your app. The returned value corresponds to the current memory limit minus the memory footprint of your app at the time of the function call. Your app's memory footprint consists of the data that you allocated in RAM, and that must stay in RAM (or the equivalent) at all times. Memory limits can change during the app life cycle and don't necessarily correspond to the amount of physical memory available on the device.
Use the returned value as advisory information only and don't cache it. The precise value changes when your app does any work that affects memory, which can happen frequently.
Although this function lets you determine the amount of memory your app may safely consume, don't use it to maximize your app's memory usage. Significant memory use, even when under the current memory limit, affects system performance. For example, when your app consumes all of its available memory, the system may need to terminate other apps and system processes to accommodate your app's requests. Instead, always consume the smallest amount of memory you need to be responsive to the user's needs.
If you need more detailed information about the available memory resources, you can call
task_info
. However, be aware thattask_info
is an expensive call, whereas this function is much more efficient.
if (@available(iOS 13.0, *)) { return os_proc_available_memory() / 1024.0 / 1024.0; }
App 內存信息的 API 能夠在 Mach 層找到,mach_task_basic_info
結構體存儲了 Mach task 的內存使用信息,其中 phys_footprint 就是應用使用的物理內存大小,virtual_size 是虛擬內存大小。
#define MACH_TASK_BASIC_INFO 20 /* always 64-bit basic info */ struct mach_task_basic_info { mach_vm_size_t virtual_size; /* virtual memory size (bytes) */ mach_vm_size_t resident_size; /* resident memory size (bytes) */ mach_vm_size_t resident_size_max; /* maximum resident memory size (bytes) */ time_value_t user_time; /* total user run time for terminated threads */ time_value_t system_time; /* total system run time for terminated threads */ policy_t policy; /* default policy for new threads */ integer_t suspend_count; /* suspend count for task */ };
因此獲取代碼爲
task_vm_info_data_t vmInfo; mach_msg_type_number_t count = TASK_VM_INFO_COUNT; kern_return_t kr = task_info(mach_task_self(), TASK_VM_INFO, (task_info_t)&vmInfo, &count); if (kr != KERN_SUCCESS) { return ; } CGFloat memoryUsed = (CGFloat)(vmInfo.phys_footprint/1024.0/1024.0);
可能有人好奇不該該是 resident_size
這個字段獲取內存的使用狀況嗎?一開始測試後發現 resident_size 和 Xcode 測量結果差距較大。而使用 phys_footprint 則接近於 Xcode 給出的結果。且能夠從 WebKit 源碼中獲得印證。
因此在 iOS13 上,咱們能夠經過 os_proc_available_memory
獲取到當前能夠用內存,經過 phys_footprint
獲取到當前 App 佔用內存,2者的和也就是當前設備的內存上限,超過即觸發 Jetsam 機制。
- (CGFloat)limitSizeOfMemory { if (@available(iOS 13.0, *)) { task_vm_info_data_t taskInfo; mach_msg_type_number_t infoCount = TASK_VM_INFO_COUNT; kern_return_t kernReturn = task_info(mach_task_self(), TASK_VM_INFO, (task_info_t)&taskInfo, &infoCount); if (kernReturn != KERN_SUCCESS) { return 0; } return (CGFloat)((taskInfo.phys_footprint + os_proc_available_memory()) / (1024.0 * 1024.0); } return 0; }
當前能夠使用內存:1435.936752MB;當前 App 已佔用內存:14.5MB,臨界值:1435.936752MB + 14.5MB= 1450.436MB, 和 3.1 方法中獲取到的內存臨界值同樣「iPhone 6s plus/13.3.1 手機 OOM 臨界值爲:(16384*92806)/(1024*1024)=1450.09375M」。
在 XNU 中,有專門用於獲取內存上限值的函數和宏,能夠經過 memorystatus_priority_entry
這個結構體獲得全部進程的優先級和內存限制值。
typedef struct memorystatus_priority_entry { pid_t pid; int32_t priority; uint64_t user_data; int32_t limit; uint32_t state; } memorystatus_priority_entry_t;
其中,priority 表明進程優先級,limit 表明進程的內存限制值。可是這種方式須要 root 權限,因爲沒有越獄設備,我沒有嘗試過。
相關代碼可查閱 kern_memorystatus.h
文件。須要用到函數 int memorystatus_control(uint32_t command, int32_t pid, uint32_t flags, void *buffer, size_t buffersize);
/* Commands */ #define MEMORYSTATUS_CMD_GET_PRIORITY_LIST 1 #define MEMORYSTATUS_CMD_SET_PRIORITY_PROPERTIES 2 #define MEMORYSTATUS_CMD_GET_JETSAM_SNAPSHOT 3 #define MEMORYSTATUS_CMD_GET_PRESSURE_STATUS 4 #define MEMORYSTATUS_CMD_SET_JETSAM_HIGH_WATER_MARK 5 /* Set active memory limit = inactive memory limit, both non-fatal */ #define MEMORYSTATUS_CMD_SET_JETSAM_TASK_LIMIT 6 /* Set active memory limit = inactive memory limit, both fatal */ #define MEMORYSTATUS_CMD_SET_MEMLIMIT_PROPERTIES 7 /* Set memory limits plus attributes independently */ #define MEMORYSTATUS_CMD_GET_MEMLIMIT_PROPERTIES 8 /* Get memory limits plus attributes */ #define MEMORYSTATUS_CMD_PRIVILEGED_LISTENER_ENABLE 9 /* Set the task's status as a privileged listener w.r.t memory notifications */ #define MEMORYSTATUS_CMD_PRIVILEGED_LISTENER_DISABLE 10 /* Reset the task's status as a privileged listener w.r.t memory notifications */ #define MEMORYSTATUS_CMD_AGGRESSIVE_JETSAM_LENIENT_MODE_ENABLE 11 /* Enable the 'lenient' mode for aggressive jetsam. See comments in kern_memorystatus.c near the top. */ #define MEMORYSTATUS_CMD_AGGRESSIVE_JETSAM_LENIENT_MODE_DISABLE 12 /* Disable the 'lenient' mode for aggressive jetsam. */ #define MEMORYSTATUS_CMD_GET_MEMLIMIT_EXCESS 13 /* Compute how much a process's phys_footprint exceeds inactive memory limit */ #define MEMORYSTATUS_CMD_ELEVATED_INACTIVEJETSAMPRIORITY_ENABLE 14 /* Set the inactive jetsam band for a process to JETSAM_PRIORITY_ELEVATED_INACTIVE */ #define MEMORYSTATUS_CMD_ELEVATED_INACTIVEJETSAMPRIORITY_DISABLE 15 /* Reset the inactive jetsam band for a process to the default band (0)*/ #define MEMORYSTATUS_CMD_SET_PROCESS_IS_MANAGED 16 /* (Re-)Set state on a process that marks it as (un-)managed by a system entity e.g. assertiond */ #define MEMORYSTATUS_CMD_GET_PROCESS_IS_MANAGED 17 /* Return the 'managed' status of a process */ #define MEMORYSTATUS_CMD_SET_PROCESS_IS_FREEZABLE 18 /* Is the process eligible for freezing? Apps and extensions can pass in FALSE to opt out of freezing, i.e.,
僞代碼
struct memorystatus_priority_entry memStatus[NUM_ENTRIES]; size_t count = sizeof(struct memorystatus_priority_entry) * NUM_ENTRIES; int kernResult = memorystatus_control(MEMORYSTATUS_CMD_GET_PRIORITY_LIST, 0, 0, memStatus, count); if (rc < 0) { NSLog(@"memorystatus_control"); return ; } int entry = 0; for (; rc > 0; rc -= sizeof(struct memorystatus_priority_entry)){ printf ("PID: %5d\tPriority:%2d\tUser Data: %llx\tLimit:%2d\tState:%s\n", memstatus[entry].pid, memstatus[entry].priority, memstatus[entry].user_data, memstatus[entry].limit, state_to_text(memstatus[entry].state)); entry++; }
for 循環打印出每一個進程(也就是 App)的 pid、Priority、User Data、Limit、State 信息。從 log 中找出優先級爲10的進程,即咱們前臺運行的 App。爲何是10? 由於 #define JETSAM_PRIORITY_FOREGROUND 10
咱們的目的就是獲取前臺 App 的內存上限值。
OOM 致使 crash 前,app 必定會收到低內存警告嗎?
作2組對比實驗:
// 實驗1 NSMutableArray *array = [NSMutableArray array]; for (NSInteger index = 0; index < 10000000; index++) { NSString *filePath = [[NSBundle mainBundle] pathForResource:@"Info" ofType:@"plist"]; NSData *data = [NSData dataWithContentsOfFile:filePath]; [array addObject:data]; }
// 實驗2 // ViewController.m - (void)viewDidLoad { [super viewDidLoad]; dispatch_async(dispatch_get_global_queue(0, 0), ^{ NSMutableArray *array = [NSMutableArray array]; for (NSInteger index = 0; index < 10000000; index++) { NSString *filePath = [[NSBundle mainBundle] pathForResource:@"Info" ofType:@"plist"]; NSData *data = [NSData dataWithContentsOfFile:filePath]; [array addObject:data]; } }); } - (void)didReceiveMemoryWarning { NSLog(@"2"); } // AppDelegate.m - (void)applicationDidReceiveMemoryWarning:(UIApplication *)application { NSLog(@"1"); }
現象:
applicationDidReceiveMemoryWarning
先執行,隨後是當前 VC 的 didReceiveMemoryWarning
。結論:
收到低內存警告不必定會 Crash,由於有6秒鐘的系統判斷時間,6秒內內存降低了則不會 crash。發生 OOM 也不必定會收到低內存警告。
要想精確的定位問題,就須要 dump 全部對象及其內存信息。當內存接近系統內存上限的時候,收集並記錄所需信息,結合必定的數據上報機制,上傳到服務器,分析並修復。
還須要知道每一個對象具體是在哪一個函數裏建立出來的,以便還原「案發現場」。
源代碼(libmalloc/malloc),內存分配函數 malloc 和 calloc 等默認使用 nano_zone,nano_zone 是小於 256B 如下的內存分配,大於 256B 則使用 scalable_zone 來分配。
主要針對大內存的分配監控。malloc 函數用的是 malloc_zone_malloc, calloc 用的是 malloc_zone_calloc。
使用 scalable_zone 分配內存的函數都會調用 malloc_logger 函數,由於系統爲了有個地方專門統計並管理內存分配狀況。這樣的設計也知足「收口原則」。
void * malloc(size_t size) { void *retval; retval = malloc_zone_malloc(default_zone, size); if (retval == NULL) { errno = ENOMEM; } return retval; } void * calloc(size_t num_items, size_t size) { void *retval; retval = malloc_zone_calloc(default_zone, num_items, size); if (retval == NULL) { errno = ENOMEM; } return retval; }
首先來看看這個 default_zone
是什麼東西, 代碼以下
typedef struct { malloc_zone_t malloc_zone; uint8_t pad[PAGE_MAX_SIZE - sizeof(malloc_zone_t)]; } virtual_default_zone_t; static virtual_default_zone_t virtual_default_zone __attribute__((section("__DATA,__v_zone"))) __attribute__((aligned(PAGE_MAX_SIZE))) = { NULL, NULL, default_zone_size, default_zone_malloc, default_zone_calloc, default_zone_valloc, default_zone_free, default_zone_realloc, default_zone_destroy, DEFAULT_MALLOC_ZONE_STRING, default_zone_batch_malloc, default_zone_batch_free, &default_zone_introspect, 10, default_zone_memalign, default_zone_free_definite_size, default_zone_pressure_relief, default_zone_malloc_claimed_address, }; static malloc_zone_t *default_zone = &virtual_default_zone.malloc_zone; static void * default_zone_malloc(malloc_zone_t *zone, size_t size) { zone = runtime_default_zone(); return zone->malloc(zone, size); } MALLOC_ALWAYS_INLINE static inline malloc_zone_t * runtime_default_zone() { return (lite_zone) ? lite_zone : inline_malloc_default_zone(); }
能夠看到 default_zone
經過這種方式來初始化
static inline malloc_zone_t * inline_malloc_default_zone(void) { _malloc_initialize_once(); // malloc_report(ASL_LEVEL_INFO, "In inline_malloc_default_zone with %d %d\n", malloc_num_zones, malloc_has_debug_zone); return malloc_zones[0]; }
隨後的調用以下_malloc_initialize
-> create_scalable_zone
-> create_scalable_szone
最終咱們建立了 szone_t 類型的對象,經過類型轉換,獲得了咱們的 default_zone。
malloc_zone_t * create_scalable_zone(size_t initial_size, unsigned debug_flags) { return (malloc_zone_t *) create_scalable_szone(initial_size, debug_flags); }
void *malloc_zone_malloc(malloc_zone_t *zone, size_t size) { MALLOC_TRACE(TRACE_malloc | DBG_FUNC_START, (uintptr_t)zone, size, 0, 0); void *ptr; if (malloc_check_start && (malloc_check_counter++ >= malloc_check_start)) { internal_check(); } if (size > MALLOC_ABSOLUTE_MAX_SIZE) { return NULL; } ptr = zone->malloc(zone, size); // 在 zone 分配完內存後就開始使用 malloc_logger 進行進行記錄 if (malloc_logger) { malloc_logger(MALLOC_LOG_TYPE_ALLOCATE | MALLOC_LOG_TYPE_HAS_ZONE, (uintptr_t)zone, (uintptr_t)size, 0, (uintptr_t)ptr, 0); } MALLOC_TRACE(TRACE_malloc | DBG_FUNC_END, (uintptr_t)zone, size, (uintptr_t)ptr, 0); return ptr; }
其分配實現是 zone->malloc
根據以前的分析,就是szone_t結構體對象中對應的malloc實現。
在建立szone以後,作了一系列以下的初始化操做。
// Initialize the security token. szone->cookie = (uintptr_t)malloc_entropy[0]; szone->basic_zone.version = 12; szone->basic_zone.size = (void *)szone_size; szone->basic_zone.malloc = (void *)szone_malloc; szone->basic_zone.calloc = (void *)szone_calloc; szone->basic_zone.valloc = (void *)szone_valloc; szone->basic_zone.free = (void *)szone_free; szone->basic_zone.realloc = (void *)szone_realloc; szone->basic_zone.destroy = (void *)szone_destroy; szone->basic_zone.batch_malloc = (void *)szone_batch_malloc; szone->basic_zone.batch_free = (void *)szone_batch_free; szone->basic_zone.introspect = (struct malloc_introspection_t *)&szone_introspect; szone->basic_zone.memalign = (void *)szone_memalign; szone->basic_zone.free_definite_size = (void *)szone_free_definite_size; szone->basic_zone.pressure_relief = (void *)szone_pressure_relief; szone->basic_zone.claimed_address = (void *)szone_claimed_address;
其餘使用 scalable_zone 分配內存的函數的方法也相似,因此大內存的分配,無論外部函數如何封裝,最終都會調用到 malloc_logger 函數。因此咱們能夠用 fishhook 去 hook 這個函數,而後記錄內存分配狀況,結合必定的數據上報機制,上傳到服務器,分析並修復。
// For logging VM allocation and deallocation, arg1 here // is the mach_port_name_t of the target task in which the // alloc or dealloc is occurring. For example, for mmap() // that would be mach_task_self(), but for a cross-task-capable // call such as mach_vm_map(), it is the target task. typedef void (malloc_logger_t)(uint32_t type, uintptr_t arg1, uintptr_t arg2, uintptr_t arg3, uintptr_t result, uint32_t num_hot_frames_to_skip); extern malloc_logger_t *__syscall_logger;
當 malloc_logger 和 __syscall_logger 函數指針不爲空時,malloc/free、vm_allocate/vm_deallocate 等內存分配/釋放經過這兩個指針通知上層,這也是內存調試工具 malloc stack 的實現原理。有了這兩個函數指針,咱們很容易記錄當前存活對象的內存分配信息(包括分配大小和分配堆棧)。分配堆棧能夠用 backtrace 函數捕獲,但捕獲到的地址是虛擬內存地址,不能從符號表 dsym 解析符號。因此還要記錄每一個 image 加載時的偏移 slide,這樣 符號表地址 = 堆棧地址 - slide。
小 tips:
ASLR(Address space layout randomization):常見稱呼爲位址空間隨機載入、位址空間配置隨機化、位址空間佈局隨機化,是一種防止內存損壞漏洞被利用的計算機安全技術,經過隨機放置進程關鍵數據區域的定址空間來放置攻擊者能可靠地跳轉到內存的特定位置來操做函數。現代做業系統通常都具有該機制。
函數地址 add: 函數真實的實現地址;
函數虛擬地址:vm_add
;
ASLR: slide
函數虛擬地址加載到進程內存的隨機偏移量,每一個 mach-o 的 slide 各不相同。vm_add + slide = add
。也就是:*(base +offset)= imp
。
因爲騰訊也開源了本身的 OOM 定位方案- OOMDetector ,有了現成的輪子,那麼用好就能夠了,因此對於內存的監控思路就是找到系統給 App 的內存上限,而後當接近內存上限值的時候,dump 內存狀況,組裝基礎數據信息成一個合格的上報數據,通過必定的數據上報策略到服務端,服務端消費數據,分析產生報表,客戶端工程師根據報表分析問題。不一樣工程的數據以郵件、短信、企業微信等形式通知到該項目的 owner、開發者。(狀況嚴重的會直接電話給開發者,並給主管跟進每一步的處理結果)。
問題分析處理後要麼發佈新版本,要麼 hot fix。
WWDC 2018 Session 416 - iOS Memory Deep Dive,處理圖片縮放的時候直接使用 UIImage 會在解碼時讀取文件而佔用一部份內存,還會生成中間位圖 bitmap 消耗大量內存。而 ImageIO 不存在上述2種弊端,只會佔用最終圖片大小的內存
作了2組對比實驗:給 App 顯示一張圖片
能夠看出使用 ImageIO 比使用 UIImage 直接縮放佔用內存更低。
咱們知道 autoreleasepool 對象是在 RunLoop 結束時才釋放。在 ARC 下,咱們若是在不斷申請內存,好比各類循環,那麼咱們就須要手動添加 autoreleasepool,避免短期內內存猛漲發生 OOM。
對比實驗
實驗1消耗內存 739.6M,實驗2消耗內存 587M。
Purgeable Memory
,能夠由系統自動釋放。NSCache 與 NSPureableData 的結合使用可讓系統根據狀況回收內存,也能夠在內存清理時移除對象。其餘的開發習慣就不一一描述了,良好的開發習慣和代碼意識是須要平時注意修煉的。
移動網絡環境一直很複雜,WIFI、2G、3G、4G、5G 等,用戶使用 App 的過程當中可能在這幾種類型之間切換,這也是移動網絡和傳統網絡間的一個區別,被稱爲「Connection Migration」。此外還存在 DNS 解析緩慢、失敗率高、運營商劫持等問題。用戶在使用 App 時由於某些緣由致使體驗不好,要想針對網絡狀況進行改善,必須有清晰的監控手段。
App 發送一次網絡請求通常會經歷下面幾個關鍵步驟:
Domain Name system,網絡域名名稱系統,本質上就是將域名
和IP 地址
相互映射的一個分佈式數據庫,令人們更方便的訪問互聯網。首先會查詢本地的 DNS 緩存,查找失敗就去 DNS 服務器查詢,這其中可能會通過很是多的節點,涉及到遞歸查詢和迭代查詢的過程。運營商可能不幹人事:一種狀況就是出現運營商劫持的現象,表現爲你在 App 內訪問某個網頁的時候會看到和內容不相關的廣告;另外一種可能的狀況就是把你的請求丟給很是遠的基站去作 DNS 解析,致使咱們 App 的 DNS 解析時間較長,App 網絡效率低。通常作 HTTPDNS 方案去自行解決 DNS 的問題。
關於 TCP 握手過程當中爲何是3次握手而不是2次、4次,能夠查看這篇文章。
對於 HTTPS 請求還須要作 TLS 握手,也就是密鑰協商的過程。
鏈接創建好以後就能夠發送 request,此時能夠記錄下 request start 時間
等待服務器返回響應。這個時間主要取決於資源大小,也是網絡請求過程當中最爲耗時的一個階段。
服務端返回響應給客戶端,根據 HTTP header 信息中的狀態碼判斷本次請求是否成功、是否走緩存、是否須要重定向。
名稱 | 說明 |
---|---|
NSURLConnection | 已經被廢棄。用法簡單 |
NSURLSession | iOS7.0 推出,功能更強大 |
CFNetwork | NSURL 的底層,純 C 實現 |
iOS 網絡框架層級關係以下:
iOS 網絡現狀是由4層組成的:最底層的 BSD Sockets、SecureTransport;次級底層是 CFNetwork、NSURLSession、NSURLConnection、WebView 是用 Objective-C 實現的,且調用 CFNetwork;應用層框架 AFNetworking 基於 NSURLSession、NSURLConnection 實現。
目前業界對於網絡監控主要有2種:一種是經過 NSURLProtocol 監控、一種是經過 Hook 來監控。下面介紹幾種辦法來監控網絡請求,各有優缺點。
NSURLProtocol 做爲上層接口,使用較爲簡單,但 NSURLProtocol 屬於 URL Loading System 體系中。應用協議的支持程度有限,支持 FTP、HTTP、HTTPS 等幾個應用層協議,對於其餘的協議則沒法監控,存在必定的侷限性。若是監控底層網絡庫 CFNetwork 則沒有這個限制。
對於 NSURLProtocol 的具體作法在這篇文章中講過,繼承抽象類並實現相應的方法,自定義去發起網絡請求來實現監控的目的。
iOS 10 以後,NSURLSessionTaskDelegate 中增長了一個新的代理方法:
/* * Sent when complete statistics information has been collected for the task. */ - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didFinishCollectingMetrics:(NSURLSessionTaskMetrics *)metrics API_AVAILABLE(macosx(10.12), ios(10.0), watchos(3.0), tvos(10.0));
能夠從 NSURLSessionTaskMetrics
中獲取到網絡狀況的各項指標。各項參數以下
@interface NSURLSessionTaskMetrics : NSObject /* * transactionMetrics array contains the metrics collected for every request/response transaction created during the task execution. */ @property (copy, readonly) NSArray<NSURLSessionTaskTransactionMetrics *> *transactionMetrics; /* * Interval from the task creation time to the task completion time. * Task creation time is the time when the task was instantiated. * Task completion time is the time when the task is about to change its internal state to completed. */ @property (copy, readonly) NSDateInterval *taskInterval; /* * redirectCount is the number of redirects that were recorded. */ @property (assign, readonly) NSUInteger redirectCount; - (instancetype)init API_DEPRECATED("Not supported", macos(10.12,10.15), ios(10.0,13.0), watchos(3.0,6.0), tvos(10.0,13.0)); + (instancetype)new API_DEPRECATED("Not supported", macos(10.12,10.15), ios(10.0,13.0), watchos(3.0,6.0), tvos(10.0,13.0)); @end
其中:taskInterval
表示任務從建立到完成話費的總時間,任務的建立時間是任務被實例化時的時間,任務完成時間是任務的內部狀態將要變爲完成的時間;redirectCount
表示被重定向的次數;transactionMetrics
數組包含了任務執行過程當中每一個請求/響應事務中收集的指標,各項參數以下:
/* * This class defines the performance metrics collected for a request/response transaction during the task execution. */ API_AVAILABLE(macosx(10.12), ios(10.0), watchos(3.0), tvos(10.0)) @interface NSURLSessionTaskTransactionMetrics : NSObject /* * Represents the transaction request. 請求事務 */ @property (copy, readonly) NSURLRequest *request; /* * Represents the transaction response. Can be nil if error occurred and no response was generated. 響應事務 */ @property (nullable, copy, readonly) NSURLResponse *response; /* * For all NSDate metrics below, if that aspect of the task could not be completed, then the corresponding 「EndDate」 metric will be nil. * For example, if a name lookup was started but the name lookup timed out, failed, or the client canceled the task before the name could be resolved -- then while domainLookupStartDate may be set, domainLookupEndDate will be nil along with all later metrics. */ /* * 客戶端開始請求的時間,不管是從服務器仍是從本地緩存中獲取 * fetchStartDate returns the time when the user agent started fetching the resource, whether or not the resource was retrieved from the server or local resources. * * The following metrics will be set to nil, if a persistent connection was used or the resource was retrieved from local resources: * * domainLookupStartDate * domainLookupEndDate * connectStartDate * connectEndDate * secureConnectionStartDate * secureConnectionEndDate */ @property (nullable, copy, readonly) NSDate *fetchStartDate; /* * domainLookupStartDate returns the time immediately before the user agent started the name lookup for the resource. DNS 開始解析的時間 */ @property (nullable, copy, readonly) NSDate *domainLookupStartDate; /* * domainLookupEndDate returns the time after the name lookup was completed. DNS 解析完成的時間 */ @property (nullable, copy, readonly) NSDate *domainLookupEndDate; /* * connectStartDate is the time immediately before the user agent started establishing the connection to the server. * * For example, this would correspond to the time immediately before the user agent started trying to establish the TCP connection. 客戶端與服務端開始創建 TCP 鏈接的時間 */ @property (nullable, copy, readonly) NSDate *connectStartDate; /* * If an encrypted connection was used, secureConnectionStartDate is the time immediately before the user agent started the security handshake to secure the current connection. HTTPS 的 TLS 握手開始的時間 * * For example, this would correspond to the time immediately before the user agent started the TLS handshake. * * If an encrypted connection was not used, this attribute is set to nil. */ @property (nullable, copy, readonly) NSDate *secureConnectionStartDate; /* * If an encrypted connection was used, secureConnectionEndDate is the time immediately after the security handshake completed. HTTPS 的 TLS 握手結束的時間 * * If an encrypted connection was not used, this attribute is set to nil. */ @property (nullable, copy, readonly) NSDate *secureConnectionEndDate; /* * connectEndDate is the time immediately after the user agent finished establishing the connection to the server, including completion of security-related and other handshakes. 客戶端與服務器創建 TCP 鏈接完成的時間,包括 TLS 握手時間 */ @property (nullable, copy, readonly) NSDate *connectEndDate; /* * requestStartDate is the time immediately before the user agent started requesting the source, regardless of whether the resource was retrieved from the server or local resources. 客戶端請求開始的時間,能夠理解爲開始傳輸 HTTP 請求的 header 的第一個字節時間 * * For example, this would correspond to the time immediately before the user agent sent an HTTP GET request. */ @property (nullable, copy, readonly) NSDate *requestStartDate; /* * requestEndDate is the time immediately after the user agent finished requesting the source, regardless of whether the resource was retrieved from the server or local resources. 客戶端請求結束的時間,能夠理解爲 HTTP 請求的最後一個字節傳輸完成的時間 * * For example, this would correspond to the time immediately after the user agent finished sending the last byte of the request. */ @property (nullable, copy, readonly) NSDate *requestEndDate; /* * responseStartDate is the time immediately after the user agent received the first byte of the response from the server or from local resources. 客戶端從服務端接收響應的第一個字節的時間 * * For example, this would correspond to the time immediately after the user agent received the first byte of an HTTP response. */ @property (nullable, copy, readonly) NSDate *responseStartDate; /* * responseEndDate is the time immediately after the user agent received the last byte of the resource. 客戶端從服務端接收到最後一個請求的時間 */ @property (nullable, copy, readonly) NSDate *responseEndDate; /* * The network protocol used to fetch the resource, as identified by the ALPN Protocol ID Identification Sequence [RFC7301]. * E.g., h2, http/1.1, spdy/3.1. 網絡協議名,好比 http/1.1, spdy/3.1 * * When a proxy is configured AND a tunnel connection is established, then this attribute returns the value for the tunneled protocol. * * For example: * If no proxy were used, and HTTP/2 was negotiated, then h2 would be returned. * If HTTP/1.1 were used to the proxy, and the tunneled connection was HTTP/2, then h2 would be returned. * If HTTP/1.1 were used to the proxy, and there were no tunnel, then http/1.1 would be returned. * */ @property (nullable, copy, readonly) NSString *networkProtocolName; /* * This property is set to YES if a proxy connection was used to fetch the resource. 該鏈接是否使用了代理 */ @property (assign, readonly, getter=isProxyConnection) BOOL proxyConnection; /* * This property is set to YES if a persistent connection was used to fetch the resource. 是否複用了現有鏈接 */ @property (assign, readonly, getter=isReusedConnection) BOOL reusedConnection; /* * Indicates whether the resource was loaded, pushed or retrieved from the local cache. 獲取資源來源 */ @property (assign, readonly) NSURLSessionTaskMetricsResourceFetchType resourceFetchType; /* * countOfRequestHeaderBytesSent is the number of bytes transferred for request header. 請求頭的字節數 */ @property (readonly) int64_t countOfRequestHeaderBytesSent API_AVAILABLE(macos(10.15), ios(13.0), watchos(6.0), tvos(13.0)); /* * countOfRequestBodyBytesSent is the number of bytes transferred for request body. 請求體的字節數 * It includes protocol-specific framing, transfer encoding, and content encoding. */ @property (readonly) int64_t countOfRequestBodyBytesSent API_AVAILABLE(macos(10.15), ios(13.0), watchos(6.0), tvos(13.0)); /* * countOfRequestBodyBytesBeforeEncoding is the size of upload body data, file, or stream. 上傳體數據、文件、流的大小 */ @property (readonly) int64_t countOfRequestBodyBytesBeforeEncoding API_AVAILABLE(macos(10.15), ios(13.0), watchos(6.0), tvos(13.0)); /* * countOfResponseHeaderBytesReceived is the number of bytes transferred for response header. 響應頭的字節數 */ @property (readonly) int64_t countOfResponseHeaderBytesReceived API_AVAILABLE(macos(10.15), ios(13.0), watchos(6.0), tvos(13.0)); /* * countOfResponseBodyBytesReceived is the number of bytes transferred for response body. 響應體的字節數 * It includes protocol-specific framing, transfer encoding, and content encoding. */ @property (readonly) int64_t countOfResponseBodyBytesReceived API_AVAILABLE(macos(10.15), ios(13.0), watchos(6.0), tvos(13.0)); /* * countOfResponseBodyBytesAfterDecoding is the size of data delivered to your delegate or completion handler. 給代理方法或者完成後處理的回調的數據大小 */ @property (readonly) int64_t countOfResponseBodyBytesAfterDecoding API_AVAILABLE(macos(10.15), ios(13.0), watchos(6.0), tvos(13.0)); /* * localAddress is the IP address string of the local interface for the connection. 當前鏈接下的本地接口 IP 地址 * * For multipath protocols, this is the local address of the initial flow. * * If a connection was not used, this attribute is set to nil. */ @property (nullable, copy, readonly) NSString *localAddress API_AVAILABLE(macos(10.15), ios(13.0), watchos(6.0), tvos(13.0)); /* * localPort is the port number of the local interface for the connection. 當前鏈接下的本地端口號 * * For multipath protocols, this is the local port of the initial flow. * * If a connection was not used, this attribute is set to nil. */ @property (nullable, copy, readonly) NSNumber *localPort API_AVAILABLE(macos(10.15), ios(13.0), watchos(6.0), tvos(13.0)); /* * remoteAddress is the IP address string of the remote interface for the connection. 當前鏈接下的遠端 IP 地址 * * For multipath protocols, this is the remote address of the initial flow. * * If a connection was not used, this attribute is set to nil. */ @property (nullable, copy, readonly) NSString *remoteAddress API_AVAILABLE(macos(10.15), ios(13.0), watchos(6.0), tvos(13.0)); /* * remotePort is the port number of the remote interface for the connection. 當前鏈接下的遠端端口號 * * For multipath protocols, this is the remote port of the initial flow. * * If a connection was not used, this attribute is set to nil. */ @property (nullable, copy, readonly) NSNumber *remotePort API_AVAILABLE(macos(10.15), ios(13.0), watchos(6.0), tvos(13.0)); /* * negotiatedTLSProtocolVersion is the TLS protocol version negotiated for the connection. 鏈接協商用的 TLS 協議版本號 * It is a 2-byte sequence in host byte order. * * Please refer to tls_protocol_version_t enum in Security/SecProtocolTypes.h * * If an encrypted connection was not used, this attribute is set to nil. */ @property (nullable, copy, readonly) NSNumber *negotiatedTLSProtocolVersion API_AVAILABLE(macos(10.15), ios(13.0), watchos(6.0), tvos(13.0)); /* * negotiatedTLSCipherSuite is the TLS cipher suite negotiated for the connection. 鏈接協商用的 TLS 密碼套件 * It is a 2-byte sequence in host byte order. * * Please refer to tls_ciphersuite_t enum in Security/SecProtocolTypes.h * * If an encrypted connection was not used, this attribute is set to nil. */ @property (nullable, copy, readonly) NSNumber *negotiatedTLSCipherSuite API_AVAILABLE(macos(10.15), ios(13.0), watchos(6.0), tvos(13.0)); /* * Whether the connection is established over a cellular interface. 是不是經過蜂窩網絡創建的鏈接 */ @property (readonly, getter=isCellular) BOOL cellular API_AVAILABLE(macos(10.15), ios(13.0), watchos(6.0), tvos(13.0)); /* * Whether the connection is established over an expensive interface. 是否經過昂貴的接口創建的鏈接 */ @property (readonly, getter=isExpensive) BOOL expensive API_AVAILABLE(macos(10.15), ios(13.0), watchos(6.0), tvos(13.0)); /* * Whether the connection is established over a constrained interface. 是否經過受限接口創建的鏈接 */ @property (readonly, getter=isConstrained) BOOL constrained API_AVAILABLE(macos(10.15), ios(13.0), watchos(6.0), tvos(13.0)); /* * Whether a multipath protocol is successfully negotiated for the connection. 是否爲了鏈接成功協商了多路徑協議 */ @property (readonly, getter=isMultipath) BOOL multipath API_AVAILABLE(macos(10.15), ios(13.0), watchos(6.0), tvos(13.0)); - (instancetype)init API_DEPRECATED("Not supported", macos(10.12,10.15), ios(10.0,13.0), watchos(3.0,6.0), tvos(10.0,13.0)); + (instancetype)new API_DEPRECATED("Not supported", macos(10.12,10.15), ios(10.0,13.0), watchos(3.0,6.0), tvos(10.0,13.0)); @end
網絡監控簡單代碼
// 監控基礎信息 @interface NetworkMonitorBaseDataModel : NSObject // 請求的 URL 地址 @property (nonatomic, strong) NSString *requestUrl; //請求頭 @property (nonatomic, strong) NSArray *requestHeaders; //響應頭 @property (nonatomic, strong) NSArray *responseHeaders; //GET方法 的請求參數 @property (nonatomic, strong) NSString *getRequestParams; //HTTP 方法, 好比 POST @property (nonatomic, strong) NSString *httpMethod; //協議名,如http1.0 / http1.1 / http2.0 @property (nonatomic, strong) NSString *httpProtocol; //是否使用代理 @property (nonatomic, assign) BOOL useProxy; //DNS解析後的 IP 地址 @property (nonatomic, strong) NSString *ip; @end // 監控信息模型 @interface NetworkMonitorDataModel : NetworkMonitorBaseDataModel //客戶端發起請求的時間 @property (nonatomic, assign) UInt64 requestDate; //客戶端開始請求到開始dns解析的等待時間,單位ms @property (nonatomic, assign) int waitDNSTime; //DNS 解析耗時 @property (nonatomic, assign) int dnsLookupTime; //tcp 三次握手耗時,單位ms @property (nonatomic, assign) int tcpTime; //ssl 握手耗時 @property (nonatomic, assign) int sslTime; //一個完整請求的耗時,單位ms @property (nonatomic, assign) int requestTime; //http 響應碼 @property (nonatomic, assign) NSUInteger httpCode; //發送的字節數 @property (nonatomic, assign) UInt64 sendBytes; //接收的字節數 @property (nonatomic, assign) UInt64 receiveBytes; // 錯誤信息模型 @interface NetworkMonitorErrorModel : NetworkMonitorBaseDataModel //錯誤碼 @property (nonatomic, assign) NSInteger errorCode; //錯誤次數 @property (nonatomic, assign) NSUInteger errCount; //異常名 @property (nonatomic, strong) NSString *exceptionName; //異常詳情 @property (nonatomic, strong) NSString *exceptionDetail; //異常堆棧 @property (nonatomic, strong) NSString *stackTrace; @end // 繼承自 NSURLProtocol 抽象類,實現響應方法,代理網絡請求 @interface CustomURLProtocol () <NSURLSessionTaskDelegate> @property (nonatomic, strong) NSURLSessionDataTask *dataTask; @property (nonatomic, strong) NSOperationQueue *sessionDelegateQueue; @property (nonatomic, strong) NetworkMonitorDataModel *dataModel; @property (nonatomic, strong) NetworkMonitorErrorModel *errModel; @end //使用NSURLSessionDataTask請求網絡 - (void)startLoading { NSURLSessionConfiguration *configuration = [NSURLSessionConfiguration defaultSessionConfiguration]; NSURLSession *session = [NSURLSession sessionWithConfiguration:configuration delegate:self delegateQueue:nil]; NSURLSession *session = [NSURLSession sessionWithConfiguration:configuration delegate:self delegateQueue:nil]; self.sessionDelegateQueue = [[NSOperationQueue alloc] init]; self.sessionDelegateQueue.maxConcurrentOperationCount = 1; self.sessionDelegateQueue.name = @"com.networkMonitor.session.queue"; self.dataTask = [session dataTaskWithRequest:self.request]; [self.dataTask resume]; } #pragma mark - NSURLSessionTaskDelegate - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error { if (error) { [self.client URLProtocol:self didFailWithError:error]; } else { [self.client URLProtocolDidFinishLoading:self]; } if (error) { NSURLRequest *request = task.currentRequest; if (request) { self.errModel.requestUrl = request.URL.absoluteString; self.errModel.httpMethod = request.HTTPMethod; self.errModel.requestParams = request.URL.query; } self.errModel.errorCode = error.code; self.errModel.exceptionName = error.domain; self.errModel.exceptionDetail = error.description; // 上傳 Network 數據到數據上報組件,數據上報會在 [打造功能強大、靈活可配置的數據上報組件](https://github.com/FantasticLBP/knowledge-kit/blob/master/Chapter1%20-%20iOS/1.80.md) 講 } self.dataTask = nil; } - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didFinishCollectingMetrics:(NSURLSessionTaskMetrics *)metrics { if (@available(iOS 10.0, *) && [metrics.transactionMetrics count] > 0) { [metrics.transactionMetrics enumerateObjectsUsingBlock:^(NSURLSessionTaskTransactionMetrics *_Nonnull obj, NSUInteger idx, BOOL *_Nonnull stop) { if (obj.resourceFetchType == NSURLSessionTaskMetricsResourceFetchTypeNetworkLoad) { if (obj.fetchStartDate) { self.dataModel.requestDate = [obj.fetchStartDate timeIntervalSince1970] * 1000; } if (obj.domainLookupStartDate && obj.domainLookupEndDate) { self.dataModel. waitDNSTime = ceil([obj.domainLookupStartDate timeIntervalSinceDate:obj.fetchStartDate] * 1000); self.dataModel. dnsLookupTime = ceil([obj.domainLookupEndDate timeIntervalSinceDate:obj.domainLookupStartDate] * 1000); } if (obj.connectStartDate) { if (obj.secureConnectionStartDate) { self.dataModel. waitDNSTime = ceil([obj.secureConnectionStartDate timeIntervalSinceDate:obj.connectStartDate] * 1000); } else if (obj.connectEndDate) { self.dataModel.tcpTime = ceil([obj.connectEndDate timeIntervalSinceDate:obj.connectStartDate] * 1000); } } if (obj.secureConnectionEndDate && obj.secureConnectionStartDate) { self.dataModel.sslTime = ceil([obj.secureConnectionEndDate timeIntervalSinceDate:obj.secureConnectionStartDate] * 1000); } if (obj.fetchStartDate && obj.responseEndDate) { self.dataModel.requestTime = ceil([obj.responseEndDate timeIntervalSinceDate:obj.fetchStartDate] * 1000); } self.dataModel.httpProtocol = obj.networkProtocolName; NSHTTPURLResponse *response = (NSHTTPURLResponse *)obj.response; if ([response isKindOfClass:NSHTTPURLResponse.class]) { self.dataModel.receiveBytes = response.expectedContentLength; } if ([obj respondsToSelector:@selector(_remoteAddressAndPort)]) { self.dataModel.ip = [obj valueForKey:@"_remoteAddressAndPort"]; } if ([obj respondsToSelector:@selector(_requestHeaderBytesSent)]) { self.dataModel.sendBytes = [[obj valueForKey:@"_requestHeaderBytesSent"] unsignedIntegerValue]; } if ([obj respondsToSelector:@selector(_responseHeaderBytesReceived)]) { self.dataModel.receiveBytes = [[obj valueForKey:@"_responseHeaderBytesReceived"] unsignedIntegerValue]; } self.dataModel.requestUrl = [obj.request.URL absoluteString]; self.dataModel.httpMethod = obj.request.HTTPMethod; self.dataModel.useProxy = obj.isProxyConnection; } }]; // 上傳 Network 數據到數據上報組件,數據上報會在 [打造功能強大、靈活可配置的數據上報組件](https://github.com/FantasticLBP/knowledge-kit/blob/master/Chapter1%20-%20iOS/1.80.md) 講 } }
文章上面 2.1 分析到了 NSURLSessionTaskMetrics 因爲兼容性問題,對於網絡監控來講彷佛不太完美,可是自後在搜資料的時候看到了一篇文章。文章在分析 WebView 的網絡監控的時候分析 Webkit 源碼的時候發現了下面代碼
#if !HAVE(TIMINGDATAOPTIONS) void setCollectsTimingData() { static dispatch_once_t onceToken; dispatch_once(&onceToken, ^{ [NSURLConnection _setCollectsTimingData:YES]; ... }); } #endif
也就是說明 NSURLConnection 自己有一套 TimingData
的收集 API,只是沒有暴露給開發者,蘋果本身在用而已。在 runtime header 中找到了 NSURLConnection 的 _setCollectsTimingData:
、_timingData
2個 api(iOS8 之後能夠使用)。
NSURLSession 在 iOS9 以前使用 _setCollectsTimingData:
就能夠使用 TimingData 了。
注意:
[[@"_setC" stringByAppendingString:@"ollectsT"] stringByAppendingString:@"imingData:"]
。@interface _NSURLConnectionProxy : DelegateProxy @end @implementation _NSURLConnectionProxy - (BOOL)respondsToSelector:(SEL)aSelector { if ([NSStringFromSelector(aSelector) isEqualToString:@"connectionDidFinishLoading:"]) { return YES; } return [self.target respondsToSelector:aSelector]; } - (void)forwardInvocation:(NSInvocation *)invocation { [super forwardInvocation:invocation]; if ([NSStringFromSelector(invocation.selector) isEqualToString:@"connectionDidFinishLoading:"]) { __unsafe_unretained NSURLConnection *conn; [invocation getArgument:&conn atIndex:2]; SEL selector = NSSelectorFromString([@"_timin" stringByAppendingString:@"gData"]); NSDictionary *timingData = [conn performSelector:selector]; [[NTDataKeeper shareInstance] trackTimingData:timingData request:conn.currentRequest]; } } @end @implementation NSURLConnection(tracker) + (void)load { static dispatch_once_t onceToken; dispatch_once(&onceToken, ^{ Class class = [self class]; SEL originalSelector = @selector(initWithRequest:delegate:); SEL swizzledSelector = @selector(swizzledInitWithRequest:delegate:); Method originalMethod = class_getInstanceMethod(class, originalSelector); Method swizzledMethod = class_getInstanceMethod(class, swizzledSelector); method_exchangeImplementations(originalMethod, swizzledMethod); NSString *selectorName = [[@"_setC" stringByAppendingString:@"ollectsT"] stringByAppendingString:@"imingData:"]; SEL selector = NSSelectorFromString(selectorName); [NSURLConnection performSelector:selector withObject:@(YES)]; }); } - (instancetype)swizzledInitWithRequest:(NSURLRequest *)request delegate:(id<NSURLConnectionDelegate>)delegate { if (delegate) { _NSURLConnectionProxy *proxy = [[_NSURLConnectionProxy alloc] initWithTarget:delegate]; objc_setAssociatedObject(delegate ,@"_NSURLConnectionProxy" ,proxy, OBJC_ASSOCIATION_RETAIN_NONATOMIC); return [self swizzledInitWithRequest:request delegate:(id<NSURLConnectionDelegate>)proxy]; }else{ return [self swizzledInitWithRequest:request delegate:delegate]; } } @end
iOS 中 hook 技術有2類,一種是 NSProxy,一種是 method swizzling(isa swizzling)
寫 SDK 確定不可能手動侵入業務代碼(你沒那個權限提交到線上代碼 😂),因此無論是 APM 仍是無痕埋點都是經過 Hook 的方式。
面向切面程序設計(Aspect-oriented Programming,AOP)是計算機科學中的一種程序設計範型,將橫切關注點與業務主體進一步分離,以提升程序代碼的模塊化程度。在不修改源代碼的狀況下給程序動態增長功能。其核心思想是將業務邏輯(核心關注點,系統主要功能)與公共功能(橫切關注點,好比日誌系統)進行分離,下降複雜性,保持系統模塊化程度、可維護性、可重用性。常被用在日誌系統、性能統計、安全控制、事務處理、異常處理等場景下。
在 iOS 中 AOP 的實現是基於 Runtime 機制,目前由3種方式:Method Swizzling、NSProxy、FishHook(主要用用於 hook c 代碼)。
文章上面 2.1 討論了知足大多數的需求的場景,NSURLProtocol 監控了 NSURLConnection、NSURLSession 的網絡請求,自身代理後能夠發起網絡請求並獲得諸如請求開始時間、請求結束時間、header 信息等,可是沒法獲得很是詳細的網絡性能數據,好比 DNS 開始解析時間、DNS 解析用了多久、reponse 開始返回的時間、返回了多久等。 iOS10 以後 NSURLSessionTaskDelegate 增長了一個代理方法 - (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didFinishCollectingMetrics:(NSURLSessionTaskMetrics *)metrics API_AVAILABLE(macosx(10.12), ios(10.0), watchos(3.0), tvos(10.0));
,能夠獲取到精確的各項網絡數據。可是具備兼容性。文章上面 2.2 討論了從 Webkit 源碼中獲得的信息,經過私有方法 _setCollectsTimingData:
、_timingData
能夠獲取到 TimingData。
可是若是須要監所有的網絡請求就不能知足需求了,查閱資料後發現了阿里百川有 APM 的解決方案,因而有了方案3,對於網絡監控須要作以下的處理
可能對於 CFNetwork 比較陌生,能夠看一下 CFNetwork 的層級和簡單用法
CFNetwork 的基礎是 CFSocket 和 CFStream。
CFSocket:Socket 是網絡通訊的底層基礎,可讓2個 socket 端口互發數據,iOS 中最經常使用的 socket 抽象是 BSD socket。而 CFSocket 是 BSD socket 的 OC 包裝,幾乎實現了全部的 BSD 功能,此外加入了 RunLoop。
CFStream:提供了與設備無關的讀寫數據方法,使用它能夠爲內存、文件、網絡(使用 socket)的數據創建流,使用 stream 能夠沒必要將全部數據寫入到內存中。CFStream 提供 API 對2種 CFType 對象提供抽象:CFReadStream、CFWriteStream。同時也是 CFHTTP、CFFTP 的基礎。
簡單 Demo
- (void)testCFNetwork { CFURLRef urlRef = CFURLCreateWithString(kCFAllocatorDefault, CFSTR("https://httpbin.org/get"), NULL); CFHTTPMessageRef httpMessageRef = CFHTTPMessageCreateRequest(kCFAllocatorDefault, CFSTR("GET"), urlRef, kCFHTTPVersion1_1); CFRelease(urlRef); CFReadStreamRef readStream = CFReadStreamCreateForHTTPRequest(kCFAllocatorDefault, httpMessageRef); CFRelease(httpMessageRef); CFReadStreamScheduleWithRunLoop(readStream, CFRunLoopGetCurrent(), kCFRunLoopCommonModes); CFOptionFlags eventFlags = (kCFStreamEventHasBytesAvailable | kCFStreamEventErrorOccurred | kCFStreamEventEndEncountered); CFStreamClientContext context = { 0, NULL, NULL, NULL, NULL } ; // Assigns a client to a stream, which receives callbacks when certain events occur. CFReadStreamSetClient(readStream, eventFlags, CFNetworkRequestCallback, &context); // Opens a stream for reading. CFReadStreamOpen(readStream); } // callback void CFNetworkRequestCallback (CFReadStreamRef _Null_unspecified stream, CFStreamEventType type, void * _Null_unspecified clientCallBackInfo) { CFMutableDataRef responseBytes = CFDataCreateMutable(kCFAllocatorDefault, 0); CFIndex numberOfBytesRead = 0; do { UInt8 buffer[2014]; numberOfBytesRead = CFReadStreamRead(stream, buffer, sizeof(buffer)); if (numberOfBytesRead > 0) { CFDataAppendBytes(responseBytes, buffer, numberOfBytesRead); } } while (numberOfBytesRead > 0); CFHTTPMessageRef response = (CFHTTPMessageRef)CFReadStreamCopyProperty(stream, kCFStreamPropertyHTTPResponseHeader); if (responseBytes) { if (response) { CFHTTPMessageSetBody(response, responseBytes); } CFRelease(responseBytes); } // close and cleanup CFReadStreamClose(stream); CFReadStreamUnscheduleFromRunLoop(stream, CFRunLoopGetCurrent(), kCFRunLoopCommonModes); CFRelease(stream); // print response if (response) { CFDataRef reponseBodyData = CFHTTPMessageCopyBody(response); CFRelease(response); printResponseData(reponseBodyData); CFRelease(reponseBodyData); } } void printResponseData (CFDataRef responseData) { CFIndex dataLength = CFDataGetLength(responseData); UInt8 *bytes = (UInt8 *)malloc(dataLength); CFDataGetBytes(responseData, CFRangeMake(0, CFDataGetLength(responseData)), bytes); CFStringRef responseString = CFStringCreateWithBytes(kCFAllocatorDefault, bytes, dataLength, kCFStringEncodingUTF8, TRUE); CFShow(responseString); CFRelease(responseString); free(bytes); } // console { "args": {}, "headers": { "Host": "httpbin.org", "User-Agent": "Test/1 CFNetwork/1125.2 Darwin/19.3.0", "X-Amzn-Trace-Id": "Root=1-5e8980d0-581f3f44724c7140614c2564" }, "origin": "183.159.122.102", "url": "https://httpbin.org/get" }
咱們知道 NSURLSession、NSURLConnection、CFNetwork 的使用都須要調用一堆方法進行設置而後須要設置代理對象,實現代理方法。因此針對這種狀況進行監控首先想到的是使用 runtime hook 掉方法層級。可是針對設置的代理對象的代理方法沒辦法 hook,由於不知道代理對象是哪一個類。因此想辦法能夠 hook 設置代理對象這個步驟,將代理對象替換成咱們設計好的某個類,而後讓這個類去實現 NSURLConnection、NSURLSession、CFNetwork 相關的代理方法。而後在這些方法的內部都去調用一下原代理對象的方法實現。因此咱們的需求得以知足,咱們在相應的方法裏面能夠拿到監控數據,好比請求開始時間、結束時間、狀態碼、內容大小等。
NSURLSession、NSURLConnection hook 以下。
業界有 APM 針對 CFNetwork 的方案,整理描述下:
CFNetwork 是 c 語言實現的,要對 c 代碼進行 hook 須要使用 Dynamic Loader Hook 庫 - fishhook。
Dynamic Loader(dyld)經過更新 Mach-O 文件中保存的指針的方法來綁定符號。借用它能夠在 Runtime 修改 C 函數調用的函數指針。 fishhook 的實現原理:遍歷__DATA segment
裏面__nl_symbol_ptr
、__la_symbol_ptr
兩個 section 裏面的符號,經過 Indirect Symbol Table、Symbol Table 和 String Table 的配合,找到本身要替換的函數,達到 hook 的目的。/* Returns the number of bytes read, or -1 if an error occurs preventing any
bytes from being read, or 0 if the stream's end was encountered.
It is an error to try and read from a stream that hasn't been opened first.
This call will block until at least one byte is available; it will NOT block
until the entire buffer can be filled. To avoid blocking, either poll using
CFReadStreamHasBytesAvailable() or use the run loop and listen for the
kCFStreamEventHasBytesAvailable event for notification of data available. */
CF_EXPORT
CFIndex CFReadStreamRead(CFReadStreamRef _Null_unspecified stream, UInt8 * _Null_unspecified buffer, CFIndex bufferLength);
CFNetwork 使用 CFReadStreamRef 來傳遞數據,使用回調函數的形式來接受服務器的響應。當回調函數受到
具體步驟及其關鍵代碼以下,以 NSURLConnection 舉例
這樣下來就是能夠監控到網絡信息了,而後將數據交給數據上報 SDK,按照下發的數據上報策略去上報數據。
其實,針對上述的需求還有另外一種方法同樣能夠達到目的,那就是 isa swizzling。
順道說一句,上面針對 NSURLConnection、NSURLSession、NSInputStream 代理對象的 hook 以後,利用 NSProxy 實現代理對象方法的轉發,有另外一種方法能夠實現,那就是 isa swizzling。
method swizzling 改進版以下
咱們來分析一下爲何修改 isa
能夠實現目的呢?
想一想 KVO 的實現原理?結合上面的圖
按照這個思路,咱們也能夠對 NSURLConnection、NSURLSession 的 load 方法中動態建立子類,在子類中重寫方法,好比 - (**nullable** **instancetype**)initWithRequest:(NSURLRequest *)request delegate:(**nullable** **id**)delegate startImmediately:(**BOOL**)startImmediately;
,而後將 NSURLSession、NSURLConnection 的 isa 指向動態建立的子類。在這些方法處理完以後還本來身的 isa 指針。
不過 isa swizzling 針對的仍是 method swizzling,代理對象不肯定,仍是須要 NSProxy 進行動態處理。
至於如何修改 isa,我寫一個簡單的 Demo 來模擬 KVO
本着成本的緣由,因爲如今大多數的項目的網絡能力都是經過 AFNetworking 完成的,因此本文的網絡監控能夠快速完成。
AFNetworking 在發起網絡的時候會有相應的通知。AFNetworkingTaskDidResumeNotification
和 AFNetworkingTaskDidCompleteNotification
。經過監聽通知攜帶的參數獲取網絡狀況信息。
在 networkRecoder 的方法裏面去組裝數據,交給數據上報組件,等到合適的時機策略去上報。
由於網絡是一個異步的過程,因此當網絡請求開始的時候須要爲每一個網絡設置惟一標識,等到網絡請求完成後再根據每一個請求的標識,判斷該網絡耗時多久、是否成功等。因此措施是爲 NSURLSessionTask 添加分類,經過 runtime 增長一個屬性,也就是惟一標識。
這裏插一嘴,爲 Category 命名、以及內部的屬性和方法命名的時候須要注意下。假如不注意會怎麼樣呢?假如你要爲 NSString 類增長身份證號碼中間位數隱藏的功能,那麼寫代碼久了的老司機 A,爲 NSString 增長了一個方法名,叫作 getMaskedIdCardNumber,可是他的需求是從 [9, 12] 這4位字符串隱藏掉。過了幾天同事 B 也遇到了相似的需求,他也是一位老司機,爲 NSString 增長了一個也叫 getMaskedIdCardNumber 的方法,可是他的需求是從 [8, 11] 這4位字符串隱藏,可是他引入工程後發現輸出並不符合預期,爲該方法寫的單測沒經過,他覺得本身寫錯了截取方法,檢查了幾遍才發現工程引入了另外一個 NSString 分類,裏面的方法同名 😂 真坑。
下面的例子是 SDK,可是平常開發也是同樣。
類名+SDK名稱簡寫_功能名稱
。好比當前 SDK 叫 JuhuaSuanAPM,那麼該 NSURLSessionTask Category 名稱就叫作 NSURLSessionTask+JuHuaSuanAPM_NetworkMonitor.h
SDK名稱簡寫_屬性名稱
。好比 JuhuaSuanAPM_requestId`SDK名稱簡寫_方法名稱
。好比 -(BOOL)JuhuaSuanAPM__isGzippedData
例子以下:
HTTP 請求報文結構
響應報文的結構
請求報文的格式
<method> <request-URI> <version> <headers> <entity-body>
響應報文的格式
<version> <status> <reason-phrase> <headers> <entity-body>
下圖是打開 Chrome 查看極課時間網頁的請求信息。包括響應行、響應頭、響應體等信息。
下圖是在終端使用 curl
查看一個完整的請求和響應數據
咱們都知道在 HTTP 通訊中,響應數據會使用 gzip 或其餘壓縮方式壓縮,用 NSURLProtocol 等方案監聽,用 NSData 類型去計算分析流量等會形成數據的不精確,由於正常一個 HTTP 響應體的內容是使用 gzip 或其餘壓縮方式壓縮的,因此使用 NSData 會偏大。
好比網絡斷開、App 忽然 Crash 等,因此 Request 和 Response 監控後不該該記錄在一條記錄裏
請求流量計算方式不精確
主要緣由有:
HTTPBody.length
,致使不夠精確響應流量計算方式不精確
主要緣由有:
exceptedContentLength
致使不夠準確Accept-Encoding
字段表明客戶端支持的數據壓縮方式(代表客戶端能夠正常使用數據時支持的壓縮方法),一樣服務端根據客戶端想要的壓縮方式、服務端當前支持的壓縮方式,最後處理數據,在響應頭中Content-Encoding
字段表示當前服務器採用了什麼壓縮方式。第五部分講了網絡攔截的各類原理和技術方案,這裏拿 NSURLProtocol 來講實現流量監控(Hook 的方式)。從上述知道了咱們須要什麼樣的,那麼就逐步實現吧。
NSURLResponse 沒有 Status Line 等屬性或者接口,HTTP Version 信息也沒有,因此要想獲取 Status Line 想辦法轉換到 CFNetwork 層試試看。發現有私有 API 能夠實現。
思路:將 NSURLResponse 經過 _CFURLResponse
轉換爲 CFTypeRef
,而後再將 CFTypeRef
轉換爲 CFHTTPMessageRef
,再經過 CFHTTPMessageCopyResponseStatusLine
獲取 CFHTTPMessageRef
的 Status Line 信息。
將讀取 Status Line 的功能添加一個 NSURLResponse 的分類。
allHeaderFields
獲取到 NSDictionary,而後按照 key: value
拼接成字符串,而後轉換成 NSData 計算大小
注意:key: value
key 後是有空格的,curl 或者 chrome Network 面板能夠查看印證下。
Body 部分
Body 大小的計算不能直接使用 excepectedContentLength,官方文檔說明了其不許確性,只能夠做爲參考。或者 allHeaderFields
中的 Content-Length
值也是不夠準確的。
/*!@abstract Returns the expected content length of the receiver.
@discussion Some protocol implementations report a content length
as part of delivering load metadata, but not all protocols
guarantee the amount of data that will be delivered in actuality.
Hence, this method returns an expected amount. Clients should use
this value as an advisory, and should be prepared to deal with
either more or less data.
@result The expected content length of the receiver, or -1 if
there is no expectation that can be arrived at regarding expected
content length.
*/
@property (readonly) long long expectedContentLength;
Transfer-Encoding: chunked
,則在 header 中不能有 Content-Length
,有也會被忽視。content-length
字段無關緊要keep alive
,則 Content-Length
和 chunked
必然是二選一。如果非keep alive
,則和 HTTP 1.0同樣。Content-Length
無關緊要。什麼是 Transfer-Encoding: chunked
數據以一系列分塊的形式進行發送 Content-Length
首部在這種狀況下不被髮送. 在每個分塊的開頭須要添加當前分塊的長度, 以十六進制的形式表示,後面緊跟着 \r\n
, 以後是分塊自己, 後面也是 \r\n
,終止塊是一個常規的分塊, 不一樣之處在於其長度爲0.
咱們以前拿 NSMutableData 記錄了數據,因此咱們能夠在 stopLoading
方法中計算出 Body 大小。步驟以下:
didReceiveData
中不斷添加 datastopLoading
方法中拿到 allHeaderFields
字典,獲取 Content-Encoding
key 的值,若是是 gzip,則在 stopLoading
中將 NSData 處理爲 gzip 壓縮後的數據,再計算大小。(gzip 相關功能能夠使用這個工具)須要額外計算一個空白行的長度
對於 NSURLRequest 沒有像 NSURLResponse 同樣的方法找到 StatusLine。因此兜底方案是本身根據 Status Line 的結構,本身手動構造一個。結構爲:協議版本號+空格+狀態碼+空格+狀態文本+換行
爲 NSURLRequest 添加一個專門獲取 Status Line 的分類。
一個 HTTP 請求會先構建判斷是否存在緩存,而後進行 DNS 域名解析以獲取請求域名的服務器 IP 地址。若是請求協議是 HTTPS,那麼還須要創建 TLS 鏈接。接下來就是利用 IP 地址和服務器創建 TCP 鏈接。鏈接創建以後,瀏覽器端會構建請求行、請求頭等信息,並把和該域名相關的 Cookie 等數據附加到請求頭中,而後向服務器發送構建的請求信息。
因此一個網絡監控不考慮 cookie 😂,借用王多魚的一句話「那不完犢子了嗎」。
看過一些文章說 NSURLRequest 不能完整獲取到請求頭信息。其實問題不大, 幾個信息獲取不徹底也沒辦法。衡量監控方案自己就是看接口在不一樣版本或者某些狀況下數據消耗是否異常,WebView 資源請求是否過大,相似於控制變量法的思想。
因此獲取到 NSURLRequest 的 allHeaderFields
後,加上 cookie 信息,計算完整的 Header 大小
NSURLConnection 的 HTTPBody
有可能獲取不到,問題相似於 WebView 上 ajax 等狀況。因此能夠經過 HTTPBodyStream
讀取 stream 來計算 body 大小.
- (NSURLRequest *)connection:(NSURLConnection *)connection willSendRequest:(NSURLRequest *)request redirectResponse:(NSURLResponse *)response
方法中將數據上報會在 打造功能強大、靈活可配置的數據上報組件 講移動設備上電量一直是比較敏感的問題,若是用戶在某款 App 的時候發現耗電量嚴重、手機發熱嚴重,那麼用戶很大可能會立刻卸載這款 App。因此須要在開發階段關心耗電量問題。
通常來講遇到耗電量較大,咱們立馬會想到是否是使用了定位、是否是使用了頻繁網絡請求、是否是不斷循環作某件事情?
開發階段基本沒啥問題,咱們能夠結合 Instrucments
裏的 Energy Log
工具來定位問題。可是線上問題就須要代碼去監控耗電量,能夠做爲 APM 的能力之一。
在 iOS 中,IOKit
是一個私有框架,用來獲取硬件和設備的詳細信息,也是硬件和內核服務通訊的底層框架。因此咱們能夠經過 IOKit
來獲取硬件信息,從而獲取到電量信息。步驟以下:
Package Contents
裏面找到 IOKit.framework
。 路徑爲 /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/IOKit.framework
一般咱們經過 Instrucments 裏的 Energy Log 解決了不少問題後,App 上線了,線上的耗電量解決就須要使用 APM 來解決了。耗電地方多是二方庫、三方庫,也多是某個同事的代碼。
思路是:在檢測到耗電後,先找到有問題的線程,而後堆棧 dump,還原案發現場。
在上面部分咱們知道了線程信息的結構, thread_basic_info
中有個記錄 CPU 使用率百分比的字段 cpu_usage
。因此咱們能夠經過遍歷當前線程,判斷哪一個線程的 CPU 使用率較高,從而找出有問題的線程。而後再 dump 堆棧,從而定位到發生耗電量的代碼。詳細請看 3.2 部分。
CPU 密集運算是耗電量主要緣由。因此咱們對 CPU 的使用須要精打細算。儘可能避免讓 CPU 作無用功。對於大量數據的複雜運算,能夠藉助服務器的能力、GPU 的能力。若是方案設計必須是在 CPU 上完成數據的運算,則能夠利用 GCD 技術,使用 dispatch_block_create_with_qos_class(<#dispatch_block_flags_t flags#>, dispatch_qos_class_t qos_class, <#int relative_priority#>, <#^(void)block#>)()
並指定 隊列的 qos 爲 QOS_CLASS_UTILITY
。將任務提交到這個隊列的 block 中,在 QOS_CLASS_UTILITY 模式下,系統針對大量數據的計算,作了電量優化
除了 CPU 大量運算,I/O 操做也是耗電主要緣由。業界常見方案都是將「碎片化的數據寫入磁盤存儲」這個操做延後,先在內存中聚合嗎,而後再進行磁盤存儲。碎片化數據先聚合,在內存中進行存儲的機制,iOS 提供 NSCache
這個對象。
NSCache 是線程安全的,NSCache 會在達到達預設的緩存空間的條件時清理緩存,此時會觸發 - (**void**)cache:(NSCache *)cache willEvictObject:(**id**)obj;
方法回調,在該方法內部對數據進行 I/O 操做,達到將聚合的數據 I/O 延後的目的。I/O 次數少了,對電量的消耗也就減小了。
NSCache 的使用能夠查看 SDWebImage 這個圖片加載框架。在圖片讀取緩存處理時,沒直接讀取硬盤文件(I/O),而是使用系統的 NSCache。
能夠看到主要邏輯是先從磁盤中讀取圖片,若是配置容許開啓內存緩存,則將圖片保存到 NSCache 中,使用的時候也是從 NSCache 中讀取圖片。NSCache 的 totalCostLimit、countLimit
屬性,
- (void)setObject:(ObjectType)obj forKey:(KeyType)key cost:(NSUInteger)g;
方法用來設置緩存條件。因此咱們寫磁盤、內存的文件操做時能夠借鑑該策略,以優化耗電量。
Mach 在消息傳遞基礎上實現了一套獨特的異常處理方法。Mach 異常處理在設計時考慮到:
在 Mach 中,異常是經過內核中的基礎設施-消息傳遞機制處理的。一個異常並不比一條消息複雜多少,異常由出錯的線程或者任務(經過 msg_send()) 拋出,而後由一個處理程序經過 msg_recv())捕捉。處理程序能夠處理異常,也能夠清楚異常(將異常標記爲已完成並繼續),還能夠決定終止線程。
Mach 的異常處理模型和其餘的異常處理模型不一樣,其餘模型的異常處理程序運行在出錯的線程上下文中,而 Mach 的異常處理程序在不一樣的上下文中運行異常處理程序,出錯的線程向預先指定好的異常端口發送消息,而後等待應答。每個任務均可以註冊一個異常處理端口,這個異常處理端口會對該任務中的全部線程生效。此外,每一個線程均可以經過 thread_set_exception_ports(<#thread_act_t thread#>, <#exception_mask_t exception_mask#>, <#mach_port_t new_port#>, <#exception_behavior_t behavior#>, <#thread_state_flavor_t new_flavor#>)
註冊本身的異常處理端口。一般狀況下,任務和線程的異常端口都是 NULL,也就是異常不會被處理,而一旦建立異常端口,這些端口就像系統中的其餘端口同樣,能夠轉交給其餘任務或者其餘主機。(有了端口,就能夠使用 UDP 協議,經過網絡能力讓其餘的主機上應用程序處理異常)。
發生異常時,首先嚐試將異常拋給線程的異常端口,而後嘗試拋給任務的異常端口,最後再拋給主機的異常端口(即主機註冊的默認端口)。若是沒有一個端口返回 KERN_SUCCESS
,那麼整個任務將被終止。也就是 Mach 不提供異常處理邏輯,只提供傳遞異常通知的框架。
異常首先是由處理器陷阱引起的。爲了處理陷阱,每個現代的內核都會安插陷阱處理程序。這些底層函數是由內核的彙編部分安插的。
BSD 層是用戶態主要使用的 XUN 接口,這一層展現了一個符合 POSIX 標準的接口。開發者能夠使用 UNIX 系統的一切功能,但不須要了解 Mach 層的細節實現。
Mach 已經經過異常機制提供了底層的陷進處理,而 BSD 則在異常機制之上構建了信號處理機制。硬件產生的信號被 Mach 層捕捉,而後轉換爲對應的 UNIX 信號,爲了維護一個統一的機制,操做系統和用戶產生的信號首先被轉換爲 Mach 異常,而後再轉換爲信號。
Mach 異常都在 host 層被 ux_exception
轉換爲相應的 unix 信號,並經過 threadsignal
將信號投遞到出錯的線程。
iOS 系統自帶的 Apples`s Crash Reporter 在設置中記錄 Crash 日誌,咱們先觀察下 Crash 日誌
Incident Identifier: 7FA6736D-09E8-47A1-95EC-76C4522BDE1A CrashReporter Key: 4e2d36419259f14413c3229e8b7235bcc74847f3 Hardware Model: iPhone7,1 Process: CMMonitorExample [3608] Path: /var/containers/Bundle/Application/9518A4F4-59B7-44E9-BDDA-9FBEE8CA18E5/CMMonitorExample.app/CMMonitorExample Identifier: com.Wacai.CMMonitorExample Version: 1.0 (1) Code Type: ARM-64 Parent Process: ? [1] Date/Time: 2017-01-03 11:43:03.000 +0800 OS Version: iOS 10.2 (14C92) Report Version: 104 Exception Type: EXC_CRASH (SIGABRT) Exception Codes: 0x00000000 at 0x0000000000000000 Crashed Thread: 0 Application Specific Information: *** Terminating app due to uncaught exception 'NSInvalidArgumentException', reason: '-[__NSSingleObjectArrayI objectForKey:]: unrecognized selector sent to instance 0x174015060' Thread 0 Crashed: 0 CoreFoundation 0x0000000188f291b8 0x188df9000 + 1245624 (<redacted> + 124) 1 libobjc.A.dylib 0x000000018796055c 0x187958000 + 34140 (objc_exception_throw + 56) 2 CoreFoundation 0x0000000188f30268 0x188df9000 + 1274472 (<redacted> + 140) 3 CoreFoundation 0x0000000188f2d270 0x188df9000 + 1262192 (<redacted> + 916) 4 CoreFoundation 0x0000000188e2680c 0x188df9000 + 186380 (_CF_forwarding_prep_0 + 92) 5 CMMonitorExample 0x000000010004c618 0x100044000 + 34328 (-[MakeCrashHandler throwUncaughtNSException] + 80)
會發現,Crash 日誌中 Exception Type
項由2部分組成:Mach 異常 + Unix 信號。
因此 Exception Type: EXC_CRASH (SIGABRT)
表示:Mach 層發生了 EXC_CRASH
異常,在 host 層被轉換爲 SIGABRT
信號投遞到出錯的線程。
問題: 捕獲 Mach 層異常、註冊 Unix 信號處理均可以捕獲 Crash,這兩種方式如何選擇?
答: 優選 Mach 層異常攔截。根據上面 1.2 中的描述咱們知道 Mach 層異常處理時機更早些,假如 Mach 層異常處理程序讓進程退出,這樣 Unix 信號永遠不會發生了。
業界關於崩潰日誌的收集開源項目不少,著名的有: KSCrash、plcrashreporter,提供一條龍服務的 Bugly、友盟等。咱們通常使用開源項目在此基礎上開發成符合公司內部需求的 bug 收集工具。一番對比後選擇 KSCrash。爲何選擇 KSCrash 不在本文重點。
KSCrash 功能齊全,能夠捕獲以下類型的 Crash
因此分析 iOS 端的 Crash 收集方案也就是分析 KSCrash 的 Crash 監控實現原理。
大致思路是:先建立一個異常處理端口,爲該端口申請權限,再設置異常端口、新建一個內核線程,在該線程內循環等待異常。可是爲了防止本身註冊的 Mach 層異常處理搶佔了其餘 SDK、或者業務線開發者設置的邏輯,咱們須要在最開始保存其餘的異常處理端口,等邏輯執行完後將異常處理交給其餘的端口內的邏輯處理。收集到 Crash 信息後組裝數據,寫入 json 文件。
流程圖以下:
對於 Mach 異常捕獲,能夠註冊一個異常端口,該端口負責對當前任務的全部線程進行監聽。
下面來看看關鍵代碼:
註冊 Mach 層異常監聽代碼
static bool installExceptionHandler() { KSLOG_DEBUG("Installing mach exception handler."); bool attributes_created = false; pthread_attr_t attr; kern_return_t kr; int error; // 拿到當前進程 const task_t thisTask = mach_task_self(); exception_mask_t mask = EXC_MASK_BAD_ACCESS | EXC_MASK_BAD_INSTRUCTION | EXC_MASK_ARITHMETIC | EXC_MASK_SOFTWARE | EXC_MASK_BREAKPOINT; KSLOG_DEBUG("Backing up original exception ports."); // 獲取該 Task 上的註冊好的異常端口 kr = task_get_exception_ports(thisTask, mask, g_previousExceptionPorts.masks, &g_previousExceptionPorts.count, g_previousExceptionPorts.ports, g_previousExceptionPorts.behaviors, g_previousExceptionPorts.flavors); // 獲取失敗走 failed 邏輯 if(kr != KERN_SUCCESS) { KSLOG_ERROR("task_get_exception_ports: %s", mach_error_string(kr)); goto failed; } // KSCrash 的異常爲空則走執行邏輯 if(g_exceptionPort == MACH_PORT_NULL) { KSLOG_DEBUG("Allocating new port with receive rights."); // 申請異常處理端口 kr = mach_port_allocate(thisTask, MACH_PORT_RIGHT_RECEIVE, &g_exceptionPort); if(kr != KERN_SUCCESS) { KSLOG_ERROR("mach_port_allocate: %s", mach_error_string(kr)); goto failed; } KSLOG_DEBUG("Adding send rights to port."); // 爲異常處理端口申請權限:MACH_MSG_TYPE_MAKE_SEND kr = mach_port_insert_right(thisTask, g_exceptionPort, g_exceptionPort, MACH_MSG_TYPE_MAKE_SEND); if(kr != KERN_SUCCESS) { KSLOG_ERROR("mach_port_insert_right: %s", mach_error_string(kr)); goto failed; } } KSLOG_DEBUG("Installing port as exception handler."); // 爲該 Task 設置異常處理端口 kr = task_set_exception_ports(thisTask, mask, g_exceptionPort, EXCEPTION_DEFAULT, THREAD_STATE_NONE); if(kr != KERN_SUCCESS) { KSLOG_ERROR("task_set_exception_ports: %s", mach_error_string(kr)); goto failed; } KSLOG_DEBUG("Creating secondary exception thread (suspended)."); pthread_attr_init(&attr); attributes_created = true; pthread_attr_setdetachstate(&attr, PTHREAD_CREATE_DETACHED); // 設置監控線程 error = pthread_create(&g_secondaryPThread, &attr, &handleExceptions, kThreadSecondary); if(error != 0) { KSLOG_ERROR("pthread_create_suspended_np: %s", strerror(error)); goto failed; } // 轉換爲 Mach 內核線程 g_secondaryMachThread = pthread_mach_thread_np(g_secondaryPThread); ksmc_addReservedThread(g_secondaryMachThread); KSLOG_DEBUG("Creating primary exception thread."); error = pthread_create(&g_primaryPThread, &attr, &handleExceptions, kThreadPrimary); if(error != 0) { KSLOG_ERROR("pthread_create: %s", strerror(error)); goto failed; } pthread_attr_destroy(&attr); g_primaryMachThread = pthread_mach_thread_np(g_primaryPThread); ksmc_addReservedThread(g_primaryMachThread); KSLOG_DEBUG("Mach exception handler installed."); return true; failed: KSLOG_DEBUG("Failed to install mach exception handler."); if(attributes_created) { pthread_attr_destroy(&attr); } // 還原以前的異常註冊端口,將控制權還原 uninstallExceptionHandler(); return false; }
處理異常的邏輯、組裝崩潰信息
/** Our exception handler thread routine. * Wait for an exception message, uninstall our exception port, record the * exception information, and write a report. */ static void* handleExceptions(void* const userData) { MachExceptionMessage exceptionMessage = {{0}}; MachReplyMessage replyMessage = {{0}}; char* eventID = g_primaryEventID; const char* threadName = (const char*) userData; pthread_setname_np(threadName); if(threadName == kThreadSecondary) { KSLOG_DEBUG("This is the secondary thread. Suspending."); thread_suspend((thread_t)ksthread_self()); eventID = g_secondaryEventID; } // 循環讀取註冊好的異常端口信息 for(;;) { KSLOG_DEBUG("Waiting for mach exception"); // Wait for a message. kern_return_t kr = mach_msg(&exceptionMessage.header, MACH_RCV_MSG, 0, sizeof(exceptionMessage), g_exceptionPort, MACH_MSG_TIMEOUT_NONE, MACH_PORT_NULL); // 獲取到信息後則表明發生了 Mach 層異常,跳出 for 循環,組裝數據 if(kr == KERN_SUCCESS) { break; } // Loop and try again on failure. KSLOG_ERROR("mach_msg: %s", mach_error_string(kr)); } KSLOG_DEBUG("Trapped mach exception code 0x%x, subcode 0x%x", exceptionMessage.code[0], exceptionMessage.code[1]); if(g_isEnabled) { // 掛起全部線程 ksmc_suspendEnvironment(); g_isHandlingCrash = true; // 通知發生了異常 kscm_notifyFatalExceptionCaptured(true); KSLOG_DEBUG("Exception handler is installed. Continuing exception handling."); // Switch to the secondary thread if necessary, or uninstall the handler // to avoid a death loop. if(ksthread_self() == g_primaryMachThread) { KSLOG_DEBUG("This is the primary exception thread. Activating secondary thread."); // TODO: This was put here to avoid a freeze. Does secondary thread ever fire? restoreExceptionPorts(); if(thread_resume(g_secondaryMachThread) != KERN_SUCCESS) { KSLOG_DEBUG("Could not activate secondary thread. Restoring original exception ports."); } } else { KSLOG_DEBUG("This is the secondary exception thread. Restoring original exception ports."); // restoreExceptionPorts(); } // Fill out crash information // 組裝異常所須要的方案現場信息 KSLOG_DEBUG("Fetching machine state."); KSMC_NEW_CONTEXT(machineContext); KSCrash_MonitorContext* crashContext = &g_monitorContext; crashContext->offendingMachineContext = machineContext; kssc_initCursor(&g_stackCursor, NULL, NULL); if(ksmc_getContextForThread(exceptionMessage.thread.name, machineContext, true)) { kssc_initWithMachineContext(&g_stackCursor, 100, machineContext); KSLOG_TRACE("Fault address 0x%x, instruction address 0x%x", kscpu_faultAddress(machineContext), kscpu_instructionAddress(machineContext)); if(exceptionMessage.exception == EXC_BAD_ACCESS) { crashContext->faultAddress = kscpu_faultAddress(machineContext); } else { crashContext->faultAddress = kscpu_instructionAddress(machineContext); } } KSLOG_DEBUG("Filling out context."); crashContext->crashType = KSCrashMonitorTypeMachException; crashContext->eventID = eventID; crashContext->registersAreValid = true; crashContext->mach.type = exceptionMessage.exception; crashContext->mach.code = exceptionMessage.code[0]; crashContext->mach.subcode = exceptionMessage.code[1]; if(crashContext->mach.code == KERN_PROTECTION_FAILURE && crashContext->isStackOverflow) { // A stack overflow should return KERN_INVALID_ADDRESS, but // when a stack blasts through the guard pages at the top of the stack, // it generates KERN_PROTECTION_FAILURE. Correct for this. crashContext->mach.code = KERN_INVALID_ADDRESS; } crashContext->signal.signum = signalForMachException(crashContext->mach.type, crashContext->mach.code); crashContext->stackCursor = &g_stackCursor; kscm_handleException(crashContext); KSLOG_DEBUG("Crash handling complete. Restoring original handlers."); g_isHandlingCrash = false; ksmc_resumeEnvironment(); } KSLOG_DEBUG("Replying to mach exception message."); // Send a reply saying "I didn't handle this exception". replyMessage.header = exceptionMessage.header; replyMessage.NDR = exceptionMessage.NDR; replyMessage.returnCode = KERN_FAILURE; mach_msg(&replyMessage.header, MACH_SEND_MSG, sizeof(replyMessage), 0, MACH_PORT_NULL, MACH_MSG_TIMEOUT_NONE, MACH_PORT_NULL); return NULL; }
還原異常處理端口,轉移控制權
/** Restore the original mach exception ports. */ static void restoreExceptionPorts(void) { KSLOG_DEBUG("Restoring original exception ports."); if(g_previousExceptionPorts.count == 0) { KSLOG_DEBUG("Original exception ports were already restored."); return; } const task_t thisTask = mach_task_self(); kern_return_t kr; // Reinstall old exception ports. // for 循環去除保存好的在 KSCrash 以前註冊好的異常端口,將每一個端口註冊回去 for(mach_msg_type_number_t i = 0; i < g_previousExceptionPorts.count; i++) { KSLOG_TRACE("Restoring port index %d", i); kr = task_set_exception_ports(thisTask, g_previousExceptionPorts.masks[i], g_previousExceptionPorts.ports[i], g_previousExceptionPorts.behaviors[i], g_previousExceptionPorts.flavors[i]); if(kr != KERN_SUCCESS) { KSLOG_ERROR("task_set_exception_ports: %s", mach_error_string(kr)); } } KSLOG_DEBUG("Exception ports restored."); g_previousExceptionPorts.count = 0; }
對於 Mach 異常,操做系統會將其轉換爲對應的 Unix 信號
,因此開發者能夠經過註冊 signanHandler
的方式來處理。
KSCrash 在這裏的處理邏輯以下圖:
看一下關鍵代碼:
設置信號處理函數
static bool installSignalHandler() { KSLOG_DEBUG("Installing signal handler."); #if KSCRASH_HAS_SIGNAL_STACK // 在堆上分配一塊內存, if(g_signalStack.ss_size == 0) { KSLOG_DEBUG("Allocating signal stack area."); g_signalStack.ss_size = SIGSTKSZ; g_signalStack.ss_sp = malloc(g_signalStack.ss_size); } // 信號處理函數的棧挪到堆中,而不和進程共用一塊棧區 // sigaltstack() 函數,該函數的第 1 個參數 sigstack 是一個 stack_t 結構的指針,該結構存儲了一個「可替換信號棧」 的位置及屬性信息。第 2 個參數 old_sigstack 也是一個 stack_t 類型指針,它用來返回上一次創建的「可替換信號棧」的信息(若是有的話) KSLOG_DEBUG("Setting signal stack area."); // sigaltstack 第一個參數爲建立的新的可替換信號棧,第二個參數能夠設置爲NULL,若是不爲NULL的話,將會將舊的可替換信號棧的信息保存在裏面。函數成功返回0,失敗返回-1. if(sigaltstack(&g_signalStack, NULL) != 0) { KSLOG_ERROR("signalstack: %s", strerror(errno)); goto failed; } #endif const int* fatalSignals = kssignal_fatalSignals(); int fatalSignalsCount = kssignal_numFatalSignals(); if(g_previousSignalHandlers == NULL) { KSLOG_DEBUG("Allocating memory to store previous signal handlers."); g_previousSignalHandlers = malloc(sizeof(*g_previousSignalHandlers) * (unsigned)fatalSignalsCount); } // 設置信號處理函數 sigaction 的第二個參數,類型爲 sigaction 結構體 struct sigaction action = {{0}}; // sa_flags 成員設立 SA_ONSTACK 標誌,該標誌告訴內核信號處理函數的棧幀就在「可替換信號棧」上創建。 action.sa_flags = SA_SIGINFO | SA_ONSTACK; #if KSCRASH_HOST_APPLE && defined(__LP64__) action.sa_flags |= SA_64REGSET; #endif sigemptyset(&action.sa_mask); action.sa_sigaction = &handleSignal; // 遍歷須要處理的信號數組 for(int i = 0; i < fatalSignalsCount; i++) { // 將每一個信號的處理函數綁定到上面聲明的 action 去,另外用 g_previousSignalHandlers 保存當前信號的處理函數 KSLOG_DEBUG("Assigning handler for signal %d", fatalSignals[i]); if(sigaction(fatalSignals[i], &action, &g_previousSignalHandlers[i]) != 0) { char sigNameBuff[30]; const char* sigName = kssignal_signalName(fatalSignals[i]); if(sigName == NULL) { snprintf(sigNameBuff, sizeof(sigNameBuff), "%d", fatalSignals[i]); sigName = sigNameBuff; } KSLOG_ERROR("sigaction (%s): %s", sigName, strerror(errno)); // Try to reverse the damage for(i--;i >= 0; i--) { sigaction(fatalSignals[i], &g_previousSignalHandlers[i], NULL); } goto failed; } } KSLOG_DEBUG("Signal handlers installed."); return true; failed: KSLOG_DEBUG("Failed to install signal handlers."); return false; }
信號處理時記錄線程等上下文信息
static void handleSignal(int sigNum, siginfo_t* signalInfo, void* userContext) { KSLOG_DEBUG("Trapped signal %d", sigNum); if(g_isEnabled) { ksmc_suspendEnvironment(); kscm_notifyFatalExceptionCaptured(false); KSLOG_DEBUG("Filling out context."); KSMC_NEW_CONTEXT(machineContext); ksmc_getContextForSignal(userContext, machineContext); kssc_initWithMachineContext(&g_stackCursor, 100, machineContext); // 記錄信號處理時的上下文信息 KSCrash_MonitorContext* crashContext = &g_monitorContext; memset(crashContext, 0, sizeof(*crashContext)); crashContext->crashType = KSCrashMonitorTypeSignal; crashContext->eventID = g_eventID; crashContext->offendingMachineContext = machineContext; crashContext->registersAreValid = true; crashContext->faultAddress = (uintptr_t)signalInfo->si_addr; crashContext->signal.userContext = userContext; crashContext->signal.signum = signalInfo->si_signo; crashContext->signal.sigcode = signalInfo->si_code; crashContext->stackCursor = &g_stackCursor; kscm_handleException(crashContext); ksmc_resumeEnvironment(); } KSLOG_DEBUG("Re-raising signal for regular handlers to catch."); // This is technically not allowed, but it works in OSX and iOS. raise(sigNum); }
KSCrash 信號處理後還原以前的信號處理權限
static void uninstallSignalHandler(void) { KSLOG_DEBUG("Uninstalling signal handlers."); const int* fatalSignals = kssignal_fatalSignals(); int fatalSignalsCount = kssignal_numFatalSignals(); // 遍歷須要處理信號數組,將以前的信號處理函數還原 for(int i = 0; i < fatalSignalsCount; i++) { KSLOG_DEBUG("Restoring original handler for signal %d", fatalSignals[i]); sigaction(fatalSignals[i], &g_previousSignalHandlers[i], NULL); } KSLOG_DEBUG("Signal handlers uninstalled."); }
說明:
爲何這麼作?一個進程可能有 n 個線程,每一個線程都有本身的任務,假如某個線程執行出錯,這樣就會致使整個進程的崩潰。因此爲了信號處理函數正常運行,須要爲信號處理函數設置單獨的運行空間。另外一種狀況是遞歸函數將系統默認的棧空間用盡了,可是信號處理函數使用的棧是它實如今堆中分配的空間,而不是系統默認的棧,因此它仍舊能夠正常工做。
int sigaltstack(const stack_t * __restrict, stack_t * __restrict)
函數的二個參數都是 stack_t
結構的指針,存儲了可替換信號棧的信息(棧的起始地址、棧的長度、狀態)。第1個參數該結構存儲了一個「可替換信號棧」 的位置及屬性信息。第 2 個參數用來返回上一次創建的「可替換信號棧」的信息(若是有的話)。
_STRUCT_SIGALTSTACK { void *ss_sp; /* signal stack base */ __darwin_size_t ss_size; /* signal stack length */ int ss_flags; /* SA_DISABLE and/or SA_ONSTACK */ }; typedef _STRUCT_SIGALTSTACK stack_t; /* [???] signal stack */
新建立的可替換信號棧,ss_flags
必須設置爲 0。系統定義了 SIGSTKSZ
常量,可知足絕大多可替換信號棧的需求。
sigaltstack
系統調用通知內核「可替換信號棧」已經創建。
ss_flags
爲 SS_ONSTACK
時,表示進程當前正在「可替換信號棧」中執行,若是此時試圖去創建一個新的「可替換信號棧」,那麼會遇到 EPERM
(禁止該動做) 的錯誤;爲 SS_DISABLE
說明當前沒有已創建的「可替換信號棧」,禁止創建「可替換信號棧」。
int sigaction(int, const struct sigaction * __restrict, struct sigaction * __restrict);
第一個函數表示須要處理的信號值,但不能是 SIGKILL
和 SIGSTOP
,這兩個信號的處理函數不容許用戶重寫,由於它們給超級用戶提供了終止程序的方法( SIGKILL
and SIGSTOP
cannot be caught, blocked, or ignored);
第二個和第三個參數是一個 sigaction
結構體。若是第二個參數不爲空則表明將其指向信號處理函數,第三個參數不爲空,則將以前的信號處理函數保存到該指針中。若是第二個參數爲空,第三個參數不爲空,則能夠獲取當前的信號處理函數。
sigaction
函數的 sa_flags
參數須要設置 SA_ONSTACK
標誌,告訴內核信號處理函數的棧幀就在「可替換信號棧」上創建。
c++ 異常處理的實現是依靠了標準庫的 std::set_terminate(CPPExceptionTerminate)
函數。
iOS 工程中某些功能的實現可能使用了C、C++等。假如拋出 C++ 異常,若是該異常能夠被轉換爲 NSException,則走 OC 異常捕獲機制,若是不能轉換,則繼續走 C++ 異常流程,也就是 default_terminate_handler
。這個 C++ 異常的默認 terminate 函數內部調用 abort_message
函數,最後觸發了一個 abort
調用,系統產生一個 SIGABRT
信號。
在系統拋出 C++ 異常後,加一層 try...catch...
來判斷該異常是否能夠轉換爲 NSException
,再從新拋出的C++異常。此時異常的現場堆棧已經消失,因此上層經過捕獲 SIGABRT
信號是沒法還原發生異常時的場景,即異常堆棧缺失。
爲何?try...catch...
語句內部會調用 __cxa_rethrow()
拋出異常,__cxa_rethrow()
內部又會調用 unwind
,unwind
能夠簡單理解爲函數調用的逆調用,主要用來清理函數調用過程當中每一個函數生成的局部變量,一直到最外層的 catch 語句所在的函數,並把控制移交給 catch 語句,這就是C++異常的堆棧消失緣由。
static void setEnabled(bool isEnabled) { if(isEnabled != g_isEnabled) { g_isEnabled = isEnabled; if(isEnabled) { initialize(); ksid_generate(g_eventID); g_originalTerminateHandler = std::set_terminate(CPPExceptionTerminate); } else { std::set_terminate(g_originalTerminateHandler); } g_captureNextStackTrace = isEnabled; } } static void initialize() { static bool isInitialized = false; if(!isInitialized) { isInitialized = true; kssc_initCursor(&g_stackCursor, NULL, NULL); } } void kssc_initCursor(KSStackCursor *cursor, void (*resetCursor)(KSStackCursor*), bool (*advanceCursor)(KSStackCursor*)) { cursor->symbolicate = kssymbolicator_symbolicate; cursor->advanceCursor = advanceCursor != NULL ? advanceCursor : g_advanceCursor; cursor->resetCursor = resetCursor != NULL ? resetCursor : kssc_resetCursor; cursor->resetCursor(cursor); }
對於 OC 層面的 NSException 異常處理較爲容易,能夠經過註冊 NSUncaughtExceptionHandler
來捕獲異常信息,經過 NSException 參數來作 Crash 信息的收集,交給數據上報組件。
static void setEnabled(bool isEnabled) { if(isEnabled != g_isEnabled) { g_isEnabled = isEnabled; if(isEnabled) { KSLOG_DEBUG(@"Backing up original handler."); // 記錄以前的 OC 異常處理函數 g_previousUncaughtExceptionHandler = NSGetUncaughtExceptionHandler(); KSLOG_DEBUG(@"Setting new handler."); // 設置新的 OC 異常處理函數 NSSetUncaughtExceptionHandler(&handleException); KSCrash.sharedInstance.uncaughtExceptionHandler = &handleException; } else { KSLOG_DEBUG(@"Restoring original handler."); NSSetUncaughtExceptionHandler(g_previousUncaughtExceptionHandler); } } }
主線程死鎖的檢測和 ANR 的檢測有些相似
do...while...
循環處理邏輯,加了 autorelease 避免內存太高awaitingResponse
屬性和 watchdogPulse
方法。watchdogPulse 主要邏輯爲設置 awaitingResponse
爲 YES,切換到主線程中,設置 awaitingResponse
爲 NO,g_watchdogInterval
後判斷 awaitingResponse
的屬性值是否是初始狀態的值,不然判斷爲死鎖上面的部分講過了 iOS 應用開發中的各類 crash 監控邏輯,接下來就應該分析下 crash 捕獲後如何將 crash 信息記錄下來,也就是保存到應用沙盒中。
拿主線程死鎖這種 crash 舉例子,看看 KSCrash 是如何記錄 crash 信息的。
// KSCrashMonitor_Deadlock.m - (void) handleDeadlock { ksmc_suspendEnvironment(); kscm_notifyFatalExceptionCaptured(false); KSMC_NEW_CONTEXT(machineContext); ksmc_getContextForThread(g_mainQueueThread, machineContext, false); KSStackCursor stackCursor; kssc_initWithMachineContext(&stackCursor, 100, machineContext); char eventID[37]; ksid_generate(eventID); KSLOG_DEBUG(@"Filling out context."); KSCrash_MonitorContext* crashContext = &g_monitorContext; memset(crashContext, 0, sizeof(*crashContext)); crashContext->crashType = KSCrashMonitorTypeMainThreadDeadlock; crashContext->eventID = eventID; crashContext->registersAreValid = false; crashContext->offendingMachineContext = machineContext; crashContext->stackCursor = &stackCursor; kscm_handleException(crashContext); ksmc_resumeEnvironment(); KSLOG_DEBUG(@"Calling abort()"); abort(); }
其餘幾個 crash 也是同樣,異常信息通過包裝交給 kscm_handleException()
函數處理。能夠看到這個函數被其餘幾種 crash 捕獲後所調用。
/** Start general exception processing. * * @oaram context Contextual information about the exception. */ void kscm_handleException(struct KSCrash_MonitorContext* context) { context->requiresAsyncSafety = g_requiresAsyncSafety; if(g_crashedDuringExceptionHandling) { context->crashedDuringCrashHandling = true; } for(int i = 0; i < g_monitorsCount; i++) { Monitor* monitor = &g_monitors[i]; // 判斷當前的 crash 監控是開啓狀態 if(isMonitorEnabled(monitor)) { // 針對每種 crash 類型作一些額外的補充信息 addContextualInfoToEvent(monitor, context); } } // 真正處理 crash 信息,保存 json 格式的 crash 信息 g_onExceptionEvent(context); if(g_handlingFatalException && !g_crashedDuringExceptionHandling) { KSLOG_DEBUG("Exception is fatal. Restoring original handlers."); kscm_setActiveMonitors(KSCrashMonitorTypeNone); } }
g_onExceptionEvent
是一個 block,聲明爲 static void (*g_onExceptionEvent)(struct KSCrash_MonitorContext* monitorContext);
在 KSCrashMonitor.c
中被賦值
void kscm_setEventCallback(void (*onEvent)(struct KSCrash_MonitorContext* monitorContext)) { g_onExceptionEvent = onEvent; }
kscm_setEventCallback()
函數在 KSCrashC.c
文件中被調用
KSCrashMonitorType kscrash_install(const char* appName, const char* const installPath) { KSLOG_DEBUG("Installing crash reporter."); if(g_installed) { KSLOG_DEBUG("Crash reporter already installed."); return g_monitoring; } g_installed = 1; char path[KSFU_MAX_PATH_LENGTH]; snprintf(path, sizeof(path), "%s/Reports", installPath); ksfu_makePath(path); kscrs_initialize(appName, path); snprintf(path, sizeof(path), "%s/Data", installPath); ksfu_makePath(path); snprintf(path, sizeof(path), "%s/Data/CrashState.json", installPath); kscrashstate_initialize(path); snprintf(g_consoleLogPath, sizeof(g_consoleLogPath), "%s/Data/ConsoleLog.txt", installPath); if(g_shouldPrintPreviousLog) { printPreviousLog(g_consoleLogPath); } kslog_setLogFilename(g_consoleLogPath, true); ksccd_init(60); // 設置 crash 發生時的 callback 函數 kscm_setEventCallback(onCrash); KSCrashMonitorType monitors = kscrash_setMonitoring(g_monitoring); KSLOG_DEBUG("Installation complete."); return monitors; } /** Called when a crash occurs. * * This function gets passed as a callback to a crash handler. */ static void onCrash(struct KSCrash_MonitorContext* monitorContext) { KSLOG_DEBUG("Updating application state to note crash."); kscrashstate_notifyAppCrash(); monitorContext->consoleLogPath = g_shouldAddConsoleLogToReport ? g_consoleLogPath : NULL; // 正在處理 crash 的時候,發生了再次 crash if(monitorContext->crashedDuringCrashHandling) { kscrashreport_writeRecrashReport(monitorContext, g_lastCrashReportFilePath); } else { // 1. 先根據當前時間建立新的 crash 的文件路徑 char crashReportFilePath[KSFU_MAX_PATH_LENGTH]; kscrs_getNextCrashReportPath(crashReportFilePath); // 2. 將新生成的文件路徑保存到 g_lastCrashReportFilePath strncpy(g_lastCrashReportFilePath, crashReportFilePath, sizeof(g_lastCrashReportFilePath)); // 3. 將新生成的文件路徑傳入函數進行 crash 寫入 kscrashreport_writeStandardReport(monitorContext, crashReportFilePath); } }
接下來的函數就是具體的日誌寫入文件的實現。2個函數作的事情類似,都是格式化爲 json 形式並寫入文件。區別在於 crash 寫入時若是再次發生 crash, 則走簡易版的寫入邏輯 kscrashreport_writeRecrashReport()
,不然走標準的寫入邏輯 kscrashreport_writeStandardReport()
。
bool ksfu_openBufferedWriter(KSBufferedWriter* writer, const char* const path, char* writeBuffer, int writeBufferLength) { writer->buffer = writeBuffer; writer->bufferLength = writeBufferLength; writer->position = 0; /* open() 的第二個參數描述的是文件操做的權限 #define O_RDONLY 0x0000 open for reading only #define O_WRONLY 0x0001 open for writing only #define O_RDWR 0x0002 open for reading and writing #define O_ACCMODE 0x0003 mask for above mode #define O_CREAT 0x0200 create if nonexistant #define O_TRUNC 0x0400 truncate to zero length #define O_EXCL 0x0800 error if already exists 0755:即用戶具備讀/寫/執行權限,組用戶和其它用戶具備讀寫權限; 0644:即用戶具備讀寫權限,組用戶和其它用戶具備只讀權限; 成功則返回文件描述符,若出現則返回 -1 */ writer->fd = open(path, O_RDWR | O_CREAT | O_EXCL, 0644); if(writer->fd < 0) { KSLOG_ERROR("Could not open crash report file %s: %s", path, strerror(errno)); return false; } return true; }
/** * Write a standard crash report to a file. * * @param monitorContext Contextual information about the crash and environment. * The caller must fill this out before passing it in. * * @param path The file to write to. */ void kscrashreport_writeStandardReport(const struct KSCrash_MonitorContext* const monitorContext, const char* path) { KSLOG_INFO("Writing crash report to %s", path); char writeBuffer[1024]; KSBufferedWriter bufferedWriter; if(!ksfu_openBufferedWriter(&bufferedWriter, path, writeBuffer, sizeof(writeBuffer))) { return; } ksccd_freeze(); KSJSONEncodeContext jsonContext; jsonContext.userData = &bufferedWriter; KSCrashReportWriter concreteWriter; KSCrashReportWriter* writer = &concreteWriter; prepareReportWriter(writer, &jsonContext); ksjson_beginEncode(getJsonContext(writer), true, addJSONData, &bufferedWriter); writer->beginObject(writer, KSCrashField_Report); { writeReportInfo(writer, KSCrashField_Report, KSCrashReportType_Standard, monitorContext->eventID, monitorContext->System.processName); ksfu_flushBufferedWriter(&bufferedWriter); writeBinaryImages(writer, KSCrashField_BinaryImages); ksfu_flushBufferedWriter(&bufferedWriter); writeProcessState(writer, KSCrashField_ProcessState, monitorContext); ksfu_flushBufferedWriter(&bufferedWriter); writeSystemInfo(writer, KSCrashField_System, monitorContext); ksfu_flushBufferedWriter(&bufferedWriter); writer->beginObject(writer, KSCrashField_Crash); { writeError(writer, KSCrashField_Error, monitorContext); ksfu_flushBufferedWriter(&bufferedWriter); writeAllThreads(writer, KSCrashField_Threads, monitorContext, g_introspectionRules.enabled); ksfu_flushBufferedWriter(&bufferedWriter); } writer->endContainer(writer); if(g_userInfoJSON != NULL) { addJSONElement(writer, KSCrashField_User, g_userInfoJSON, false); ksfu_flushBufferedWriter(&bufferedWriter); } else { writer->beginObject(writer, KSCrashField_User); } if(g_userSectionWriteCallback != NULL) { ksfu_flushBufferedWriter(&bufferedWriter); g_userSectionWriteCallback(writer); } writer->endContainer(writer); ksfu_flushBufferedWriter(&bufferedWriter); writeDebugInfo(writer, KSCrashField_Debug, monitorContext); } writer->endContainer(writer); ksjson_endEncode(getJsonContext(writer)); ksfu_closeBufferedWriter(&bufferedWriter); ksccd_unfreeze(); } /** Write a minimal crash report to a file. * * @param monitorContext Contextual information about the crash and environment. * The caller must fill this out before passing it in. * * @param path The file to write to. */ void kscrashreport_writeRecrashReport(const struct KSCrash_MonitorContext* const monitorContext, const char* path) { char writeBuffer[1024]; KSBufferedWriter bufferedWriter; static char tempPath[KSFU_MAX_PATH_LENGTH]; // 將傳遞過來的上份 crash report 文件名路徑(/var/mobile/Containers/Data/Application/******/Library/Caches/KSCrash/Test/Reports/Test-report-******.json)修改成去掉 .json ,加上 .old 成爲新的文件路徑 /var/mobile/Containers/Data/Application/******/Library/Caches/KSCrash/Test/Reports/Test-report-******.old strncpy(tempPath, path, sizeof(tempPath) - 10); strncpy(tempPath + strlen(tempPath) - 5, ".old", 5); KSLOG_INFO("Writing recrash report to %s", path); if(rename(path, tempPath) < 0) { KSLOG_ERROR("Could not rename %s to %s: %s", path, tempPath, strerror(errno)); } // 根據傳入路徑來打開內存寫入須要的文件 if(!ksfu_openBufferedWriter(&bufferedWriter, path, writeBuffer, sizeof(writeBuffer))) { return; } ksccd_freeze(); // json 解析的 c 代碼 KSJSONEncodeContext jsonContext; jsonContext.userData = &bufferedWriter; KSCrashReportWriter concreteWriter; KSCrashReportWriter* writer = &concreteWriter; prepareReportWriter(writer, &jsonContext); ksjson_beginEncode(getJsonContext(writer), true, addJSONData, &bufferedWriter); writer->beginObject(writer, KSCrashField_Report); { writeRecrash(writer, KSCrashField_RecrashReport, tempPath); ksfu_flushBufferedWriter(&bufferedWriter); if(remove(tempPath) < 0) { KSLOG_ERROR("Could not remove %s: %s", tempPath, strerror(errno)); } writeReportInfo(writer, KSCrashField_Report, KSCrashReportType_Minimal, monitorContext->eventID, monitorContext->System.processName); ksfu_flushBufferedWriter(&bufferedWriter); writer->beginObject(writer, KSCrashField_Crash); { writeError(writer, KSCrashField_Error, monitorContext); ksfu_flushBufferedWriter(&bufferedWriter); int threadIndex = ksmc_indexOfThread(monitorContext->offendingMachineContext, ksmc_getThreadFromContext(monitorContext->offendingMachineContext)); writeThread(writer, KSCrashField_CrashedThread, monitorContext, monitorContext->offendingMachineContext, threadIndex, false); ksfu_flushBufferedWriter(&bufferedWriter); } writer->endContainer(writer); } writer->endContainer(writer); ksjson_endEncode(getJsonContext(writer)); ksfu_closeBufferedWriter(&bufferedWriter); ksccd_unfreeze(); }
當前 App 在 Crash 以後,KSCrash 將數據保存到 App 沙盒目錄下,App 下次啓動後咱們讀取存儲的 crash 文件,而後處理數據並上傳。
App 啓動後函數調用:
[KSCrashInstallation sendAllReportsWithCompletion:]
-> [KSCrash sendAllReportsWithCompletion:]
-> [KSCrash allReports]
-> [KSCrash reportWithIntID:]
->[KSCrash loadCrashReportJSONWithID:]
-> kscrs_readReport
在 sendAllReportsWithCompletion
裏讀取沙盒裏的Crash 數據。
// 先經過讀取文件夾,遍歷文件夾內的文件數量來判斷 crash 報告的個數 static int getReportCount() { int count = 0; DIR* dir = opendir(g_reportsPath); if(dir == NULL) { KSLOG_ERROR("Could not open directory %s", g_reportsPath); goto done; } struct dirent* ent; while((ent = readdir(dir)) != NULL) { if(getReportIDFromFilename(ent->d_name) > 0) { count++; } } done: if(dir != NULL) { closedir(dir); } return count; } // 經過 crash 文件個數、文件夾信息去遍歷,一次獲取到文件名(文件名的最後一部分就是 reportID),拿到 reportID 再去讀取 crash 報告內的文件內容,寫入數組 - (NSArray*) allReports { int reportCount = kscrash_getReportCount(); int64_t reportIDs[reportCount]; reportCount = kscrash_getReportIDs(reportIDs, reportCount); NSMutableArray* reports = [NSMutableArray arrayWithCapacity:(NSUInteger)reportCount]; for(int i = 0; i < reportCount; i++) { NSDictionary* report = [self reportWithIntID:reportIDs[i]]; if(report != nil) { [reports addObject:report]; } } return reports; } // 根據 reportID 找到 crash 信息 - (NSDictionary*) reportWithIntID:(int64_t) reportID { NSData* jsonData = [self loadCrashReportJSONWithID:reportID]; if(jsonData == nil) { return nil; } NSError* error = nil; NSMutableDictionary* crashReport = [KSJSONCodec decode:jsonData options:KSJSONDecodeOptionIgnoreNullInArray | KSJSONDecodeOptionIgnoreNullInObject | KSJSONDecodeOptionKeepPartialObject error:&error]; if(error != nil) { KSLOG_ERROR(@"Encountered error loading crash report %" PRIx64 ": %@", reportID, error); } if(crashReport == nil) { KSLOG_ERROR(@"Could not load crash report"); return nil; } [self doctorReport:crashReport]; return crashReport; } // reportID 讀取 crash 內容並轉換爲 NSData 類型 - (NSData*) loadCrashReportJSONWithID:(int64_t) reportID { char* report = kscrash_readReport(reportID); if(report != NULL) { return [NSData dataWithBytesNoCopy:report length:strlen(report) freeWhenDone:YES]; } return nil; } // reportID 讀取 crash 數據到 char 類型 char* kscrash_readReport(int64_t reportID) { if(reportID <= 0) { KSLOG_ERROR("Report ID was %" PRIx64, reportID); return NULL; } char* rawReport = kscrs_readReport(reportID); if(rawReport == NULL) { KSLOG_ERROR("Failed to load report ID %" PRIx64, reportID); return NULL; } char* fixedReport = kscrf_fixupCrashReport(rawReport); if(fixedReport == NULL) { KSLOG_ERROR("Failed to fixup report ID %" PRIx64, reportID); } free(rawReport); return fixedReport; } // 多線程加鎖,經過 reportID 執行 c 函數 getCrashReportPathByID,將路徑設置到 path 上。而後執行 ksfu_readEntireFile 讀取 crash 信息到 result char* kscrs_readReport(int64_t reportID) { pthread_mutex_lock(&g_mutex); char path[KSCRS_MAX_PATH_LENGTH]; getCrashReportPathByID(reportID, path); char* result; ksfu_readEntireFile(path, &result, NULL, 2000000); pthread_mutex_unlock(&g_mutex); return result; } int kscrash_getReportIDs(int64_t* reportIDs, int count) { return kscrs_getReportIDs(reportIDs, count); } int kscrs_getReportIDs(int64_t* reportIDs, int count) { pthread_mutex_lock(&g_mutex); count = getReportIDs(reportIDs, count); pthread_mutex_unlock(&g_mutex); return count; } // 循環讀取文件夾內容,根據 ent->d_name 調用 getReportIDFromFilename 函數,來獲取 reportID,循環內部填充數組 static int getReportIDs(int64_t* reportIDs, int count) { int index = 0; DIR* dir = opendir(g_reportsPath); if(dir == NULL) { KSLOG_ERROR("Could not open directory %s", g_reportsPath); goto done; } struct dirent* ent; while((ent = readdir(dir)) != NULL && index < count) { int64_t reportID = getReportIDFromFilename(ent->d_name); if(reportID > 0) { reportIDs[index++] = reportID; } } qsort(reportIDs, (unsigned)count, sizeof(reportIDs[0]), compareInt64); done: if(dir != NULL) { closedir(dir); } return index; } // sprintf(參數1, 格式2) 函數將格式2的值返回到參數1上,而後執行 sscanf(參數1, 參數2, 參數3),函數將字符串參數1的內容,按照參數2的格式,寫入到參數3上。crash 文件命名爲 "App名稱-report-reportID.json" static int64_t getReportIDFromFilename(const char* filename) { char scanFormat[100]; sprintf(scanFormat, "%s-report-%%" PRIx64 ".json", g_appName); int64_t reportID = 0; sscanf(filename, scanFormat, &reportID); return reportID; }
這部分簡單粗暴,直接經過 JSContext 對象的 exceptionHandler 屬性來監控,好比下面的代碼
jsContext.exceptionHandler = ^(JSContext *context, JSValue *exception) { // 處理 jscore 相關的異常信息 };
當 h5 頁面內的 Javascript 運行異常時會 window 對象會觸發 ErrorEvent
接口的 error 事件,並執行 window.onerror()
。
window.onerror = function (msg, url, lineNumber, columnNumber, error) { // 處理異常信息 };
小實驗:下圖是寫了一個 RN Demo 工程,在 Debug Text 控件上加了事件監聽代碼,內部人爲觸發 crash
<Text style={styles.sectionTitle} onPress={()=>{1+qw;}}>Debug</Text>
對比組1:
條件: iOS 項目 debug 模式。在 RN 端增長了異常處理的代碼。
模擬器點擊 command + d
調出面板,選擇 Debug,打開 Chrome 瀏覽器, Mac 下快捷鍵 Command + Option + J
打開調試面板,就能夠像調試 React 同樣調試 RN 代碼了。
查看到 crash stack 後點擊能夠跳轉到 sourceMap 的地方。
Tips:RN 項目打 Release 包
在終端切換到工程目錄,而後執行下面的代碼
react-native bundle --entry-file index.js --platform ios --dev false --bundle-output release_ios/main.jsbundle --assets-dest release_iOS --sourcemap-output release_ios/index.ios.map;
.jsbundle
和 assets
文件夾內容拖入到 iOS 工程中便可對比組2:
條件:iOS 項目 release 模式。在 RN 端不增長異常處理代碼
操做:運行 iOS 工程,點擊按鈕模擬 crash
現象:iOS 項目奔潰。截圖以及日誌以下!
2020-06-22 22:26:03.318 [info][tid:main][RCTRootView.m:294] Running application todos ({ initialProps = { }; rootTag = 1; }) 2020-06-22 22:26:03.490 [info][tid:com.facebook.react.JavaScript] Running "todos" with {"rootTag":1,"initialProps":{}} 2020-06-22 22:27:38.673 [error][tid:com.facebook.react.JavaScript] ReferenceError: Can't find variable: qw 2020-06-22 22:27:38.675 [fatal][tid:com.facebook.react.ExceptionsManagerQueue] Unhandled JS Exception: ReferenceError: Can't find variable: qw 2020-06-22 22:27:38.691300+0800 todos[16790:314161] *** Terminating app due to uncaught exception 'RCTFatalException: Unhandled JS Exception: ReferenceError: Can't find variable: qw', reason: 'Unhandled JS Exception: ReferenceError: Can't find variable: qw, stack: onPress@397:1821 <unknown>@203:3896 _performSideEffectsForTransition@210:9689 _performSideEffectsForTransition@(null):(null) _receiveSignal@210:8425 _receiveSignal@(null):(null) touchableHandleResponderRelease@210:5671 touchableHandleResponderRelease@(null):(null) onResponderRelease@203:3006 b@97:1125 S@97:1268 w@97:1322 R@97:1617 M@97:2401 forEach@(null):(null) U@97:2201 <unknown>@97:13818 Pe@97:90199 Re@97:13478 Ie@97:13664 receiveTouches@97:14448 value@27:3544 <unknown>@27:840 value@27:2798 value@27:812 value@(null):(null) ' *** First throw call stack: ( 0 CoreFoundation 0x00007fff23e3cf0e __exceptionPreprocess + 350 1 libobjc.A.dylib 0x00007fff50ba89b2 objc_exception_throw + 48 2 todos 0x00000001017b0510 RCTFormatError + 0 3 todos 0x000000010182d8ca -[RCTExceptionsManager reportFatal:stack:exceptionId:suppressRedBox:] + 503 4 todos 0x000000010182e34e -[RCTExceptionsManager reportException:] + 1658 5 CoreFoundation 0x00007fff23e43e8c __invoking___ + 140 6 CoreFoundation 0x00007fff23e41071 -[NSInvocation invoke] + 321 7 CoreFoundation 0x00007fff23e41344 -[NSInvocation invokeWithTarget:] + 68 8 todos 0x00000001017e07fa -[RCTModuleMethod invokeWithBridge:module:arguments:] + 578 9 todos 0x00000001017e2a84 _ZN8facebook5reactL11invokeInnerEP9RCTBridgeP13RCTModuleDatajRKN5folly7dynamicE + 246 10 todos 0x00000001017e280c ___ZN8facebook5react15RCTNativeModule6invokeEjON5folly7dynamicEi_block_invoke + 78 11 libdispatch.dylib 0x00000001025b5f11 _dispatch_call_block_and_release + 12 12 libdispatch.dylib 0x00000001025b6e8e _dispatch_client_callout + 8 13 libdispatch.dylib 0x00000001025bd6fd _dispatch_lane_serial_drain + 788 14 libdispatch.dylib 0x00000001025be28f _dispatch_lane_invoke + 422 15 libdispatch.dylib 0x00000001025c9b65 _dispatch_workloop_worker_thread + 719 16 libsystem_pthread.dylib 0x00007fff51c08a3d _pthread_wqthread + 290 17 libsystem_pthread.dylib 0x00007fff51c07b77 start_wqthread + 15 ) libc++abi.dylib: terminating with uncaught exception of type NSException (lldb)
Tips:如何在 RN release 模式下調試(看到 js 側的 console 信息)
AppDelegate.m
中引入 #import <React/RCTLog.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
中加入 RCTSetLogThreshold(RCTLogLevelTrace);
對比組3:
條件:iOS 項目 release 模式。在 RN 端增長異常處理代碼。
global.ErrorUtils.setGlobalHandler((e) => { console.log(e); let message = { name: e.name, message: e.message, stack: e.stack }; axios.get('http://192.168.1.100:8888/test.php', { params: { 'message': JSON.stringify(message) } }).then(function (response) { console.log(response) }).catch(function (error) { console.log(error) }); }, true)
操做:運行 iOS 工程,點擊按鈕模擬 crash。
現象:iOS 項目不奔潰。日誌信息以下,對比 bundle 包中的 js。
結論:
在 RN 項目中,若是發生了 crash 則會在 Native 側有相應體現。若是 RN 側寫了 crash 捕獲的代碼,則 Native 側不會奔潰。若是 RN 側的 crash 沒有捕獲,則 Native 直接奔潰。
RN 項目寫了 crash 監控,監控後將堆棧信息打印出來發現對應的 js 信息是通過 webpack 處理的,crash 分析難度很大。因此咱們針對 RN 的 crash 須要在 RN 側寫監控代碼,監控後須要上報,此外針對監控後的信息須要寫專門的 crash 信息還原給你,也就是 sourceMap 解析。
寫過 RN 的人都知道在 DEBUG 模式下 js 代碼有問題則會產生紅屏,在 RELEASE 模式下則會白屏或者閃退,爲了體驗和質量把控須要作異常監控。
在看 RN 源碼時候發現了 ErrorUtils
,看代碼能夠設置處理錯誤信息。
/** * Copyright (c) Facebook, Inc. and its affiliates. * * This source code is licensed under the MIT license found in the * LICENSE file in the root directory of this source tree. * * @format * @flow strict * @polyfill */ let _inGuard = 0; type ErrorHandler = (error: mixed, isFatal: boolean) => void; type Fn<Args, Return> = (...Args) => Return; /** * This is the error handler that is called when we encounter an exception * when loading a module. This will report any errors encountered before * ExceptionsManager is configured. */ let _globalHandler: ErrorHandler = function onError( e: mixed, isFatal: boolean, ) { throw e; }; /** * The particular require runtime that we are using looks for a global * `ErrorUtils` object and if it exists, then it requires modules with the * error handler specified via ErrorUtils.setGlobalHandler by calling the * require function with applyWithGuard. Since the require module is loaded * before any of the modules, this ErrorUtils must be defined (and the handler * set) globally before requiring anything. */ const ErrorUtils = { setGlobalHandler(fun: ErrorHandler): void { _globalHandler = fun; }, getGlobalHandler(): ErrorHandler { return _globalHandler; }, reportError(error: mixed): void { _globalHandler && _globalHandler(error, false); }, reportFatalError(error: mixed): void { // NOTE: This has an untyped call site in Metro. _globalHandler && _globalHandler(error, true); }, applyWithGuard<TArgs: $ReadOnlyArray<mixed>, TOut>( fun: Fn<TArgs, TOut>, context?: ?mixed, args?: ?TArgs, // Unused, but some code synced from www sets it to null. unused_onError?: null, // Some callers pass a name here, which we ignore. unused_name?: ?string, ): ?TOut { try { _inGuard++; // $FlowFixMe: TODO T48204745 (1) apply(context, null) is fine. (2) array -> rest array should work return fun.apply(context, args); } catch (e) { ErrorUtils.reportError(e); } finally { _inGuard--; } return null; }, applyWithGuardIfNeeded<TArgs: $ReadOnlyArray<mixed>, TOut>( fun: Fn<TArgs, TOut>, context?: ?mixed, args?: ?TArgs, ): ?TOut { if (ErrorUtils.inGuard()) { // $FlowFixMe: TODO T48204745 (1) apply(context, null) is fine. (2) array -> rest array should work return fun.apply(context, args); } else { ErrorUtils.applyWithGuard(fun, context, args); } return null; }, inGuard(): boolean { return !!_inGuard; }, guard<TArgs: $ReadOnlyArray<mixed>, TOut>( fun: Fn<TArgs, TOut>, name?: ?string, context?: ?mixed, ): ?(...TArgs) => ?TOut { // TODO: (moti) T48204753 Make sure this warning is never hit and remove it - types // should be sufficient. if (typeof fun !== 'function') { console.warn('A function must be passed to ErrorUtils.guard, got ', fun); return null; } const guardName = name ?? fun.name ?? '<generated guard>'; function guarded(...args: TArgs): ?TOut { return ErrorUtils.applyWithGuard( fun, context ?? this, args, null, guardName, ); } return guarded; }, }; global.ErrorUtils = ErrorUtils; export type ErrorUtilsT = typeof ErrorUtils;
因此 RN 的異常能夠使用 global.ErrorUtils
來設置錯誤處理。舉個例子
global.ErrorUtils.setGlobalHandler(e => { // e.name e.message e.stack }, true);
其實對於 RN 的 crash 處理還有個須要注意的就是 React Error Boundaries。詳細資料
過去,組件內的 JavaScript 錯誤會致使 React 的內部狀態被破壞,而且在下一次渲染時 產生 可能沒法追蹤的 錯誤。這些錯誤基本上是由較早的其餘代碼(非 React 組件代碼)錯誤引發的,但 React 並無提供一種在組件中優雅處理這些錯誤的方式,也沒法從錯誤中恢復。部分 UI 的 JavaScript 錯誤不該該致使整個應用崩潰,爲了解決這個問題,React 16 引入了一個新的概念 —— 錯誤邊界。
錯誤邊界是一種 React 組件,這種組件能夠捕獲並打印發生在其子組件樹任何位置的 JavaScript 錯誤,而且,它會渲染出備用 UI,而不是渲染那些崩潰了的子組件樹。錯誤邊界在渲染期間、生命週期方法和整個組件樹的構造函數中捕獲錯誤。
它能捕獲子組件生命週期函數中的異常,包括構造函數(constructor)和 render 函數
而不能捕獲如下異常:
因此能夠經過異常邊界組件捕獲組件生命週期內的全部異常而後渲染兜底組件 ,防止 App crash,提升用戶體驗。也可引導用戶反饋問題,方便問題的排查和修復
至此 RN 的 crash 分爲2種,分別是 js 邏輯錯誤、組件 js 錯誤,都已經被監控處理了。接下來就看看如何從工程化層面解決這些問題
SourceMap 文件對於前端日誌的解析相當重要,SourceMap 文件中各個參數和如何計算的步驟都在裏面有寫,能夠查看這篇文章。
有了 SourceMap 文件,藉助於 mozilla 的 source-map 項目,能夠很好的還原 RN 的 crash 日誌。
我寫了個 NodeJS 腳本,代碼以下
var fs = require('fs'); var sourceMap = require('source-map'); var arguments = process.argv.splice(2); function parseJSError(aLine, aColumn) { fs.readFile('./index.ios.map', 'utf8', function (err, data) { const whatever = sourceMap.SourceMapConsumer.with(data, null, consumer => { // 讀取 crash 日誌的行號、列號 let parseData = consumer.originalPositionFor({ line: parseInt(aLine), column: parseInt(aColumn) }); // 輸出到控制檯 console.log(parseData); // 輸出到文件中 fs.writeFileSync('./parsed.txt', JSON.stringify(parseData) + '\n', 'utf8', function(err) { if(err) { console.log(err); } }); }); }); } var line = arguments[0]; var column = arguments[1]; parseJSError(line, column);
接下來作個實驗,仍是上述的 todos 項目。
在 Text 的點擊事件上模擬 crash
<Text style={styles.sectionTitle} onPress={()=>{1+qw;}}>Debug</Text>
將 RN 項目打 bundle 包、產出 sourceMap 文件。執行命令,
react-native bundle --entry-file index.js --platform android --dev false --bundle-output release_ios/main.jsbundle --assets-dest release_iOS --sourcemap-output release_ios/index.android.map;
由於高頻使用,因此給 iterm2 增長 alias 別名設置,修改 .zshrc
文件
alias RNRelease='react-native bundle --entry-file index.js --platform ios --dev false --bundle-output release_ios/main.jsbundle --assets-dest release_iOS --sourcemap-output release_ios/index.ios.map;' # RN 打 Release 包
點擊模擬 crash,將日誌下面的行號和列號拷貝,在 Node 項目下,執行下面命令
node index.js 397 1822
目的:經過平臺能夠將 RN 項目線上 crash 能夠還原到具體的文件、代碼行數、代碼列數。能夠看到具體的代碼,能夠看到 RN stack trace、提供源文件下載功能。
打包系統下管理的服務器:
而後再封裝本身的 Crash 處理邏輯。好比要作的事情就是:
sink
方法。sink
方法內部的 CMCrashReporterSink
類,遵循了 KSCrashReportFilter 協議,聲明瞭公有方法 defaultCrashReportFilterSetAppleFmt
其中 defaultCrashReportFilterSetAppleFmt
方法內部返回了一個 KSCrashReportFilterPipeline
類方法 filterWithFilters
的結果。
CMCrashReportFilterAppleFmt
是一個繼承自 KSCrashReportFilterAppleFmt
的類,遵循了 KSCrashReportFilter
協議。協議方法容許開發者處理 Crash 的數據格式。
在 installKSCrash
方法中調用了 [[CMCrashInstallation sharedInstance] sendAllReportsWithCompletion: nil]
,內部實現以下
方法內部將 KSCrashInstallation
的 sink
賦值給 KSCrash
對象。 內部仍是調用了 KSCrash
的 sendAllReportsWithCompletion
方法,實現以下
該方法內部調用了對象方法 sendReports: onCompletion:
,以下所示
方法內部的 [self.sink filterReports: onCompletion: ]
實現其實就是 CMCrashInstallation
中設置的 sink
getter 方法,內部返回了 CMCrashReporterSink
對象的 defaultCrashReportFilterSetAppleFmt
方法的返回值。內部實現以下
能夠看到這個函數內部設置了多個 filters,其中一個就是 self,也就是 CMCrashReporterSink
對象,因此上面的 [self.sink filterReports: onCompletion:]
,也就是調用 CMCrashReporterSink
內的數據處理方法。完了以後經過 kscrash_callCompletion(onCompletion, reports, YES, nil);
告訴 KSCrash
本地保存的 Crash 日誌已經處理完畢,能夠刪除了。
至此,歸納下 KSCrash 作的事情,提供各類 crash 的監控能力,在 crash 後將進程信息、基本信息、異常信息、線程信息等用 c 高效轉換爲 json 寫入文件,App 下次啓動後讀取本地的 crash 文件夾中的 crash 日誌,讓開發者能夠自定義 key、value 而後去上報日誌到 APM 系統,而後刪除本地 crash 文件夾中的日誌。
應用 crash 以後,系統會生成一份崩潰日誌,存儲在設置中,應用的運行狀態、調用堆棧、所處線程等信息會記錄在日誌中。可是這些日誌是地址,並不可讀,因此須要進行符號化還原。
.dSYM
(debugging symbol)文件是保存十六進制函數地址映射信息的中轉文件,調試信息(symbols)都包含在該文件中。Xcode 工程每次編譯運行都會生成新的 .dSYM
文件。默認狀況下 debug 模式時不生成 .dSYM
,能夠在 Build Settings -> Build Options -> Debug Information Format 後將值 DWARF
修改成 DWARF with dSYM File
,這樣再次編譯運行就能夠生成 .dSYM
文件。
因此每次 App 打包的時候都須要保存每一個版本的 .dSYM
文件。
.dSYM
文件中包含 DWARF 信息,打開文件的包內容 Test.app.dSYM/Contents/Resources/DWARF/Test
保存的就是 DWARF
文件。
.dSYM
文件是從 Mach-O 文件中抽取調試信息而獲得的文件目錄,發佈的時候爲了安全,會把調試信息存儲在單獨的文件,.dSYM
實際上是一個文件目錄,結構以下:
DWARF is a debugging file format used by many compilers and debuggers to support source level debugging. It addresses the requirements of a number of procedural languages, such as C, C++, and Fortran, and is designed to be extensible to other languages. DWARF is architecture independent and applicable to any processor or operating system. It is widely used on Unix, Linux and other operating systems, as well as in stand-alone environments.
DWARF 是一種調試文件格式,它被許多編譯器和調試器所普遍使用以支持源代碼級別的調試。它知足許多過程語言(C、C++、Fortran)的需求,它被設計爲支持拓展到其餘語言。DWARF 是架構獨立的,適用於其餘任何的處理器和操做系統。被普遍使用在 Unix、Linux 和其餘的操做系統上,以及獨立環境上。
DWARF 全稱是 Debugging With Arbitrary Record Formats,是一種使用屬性化記錄格式的調試文件。
DWARF 是可執行程序與源代碼關係的一個緊湊表示。
大多數現代編程語言都是塊結構:每一個實體(一個類、一個函數)被包含在另外一個實體中。一個 c 程序,每一個文件可能包含多個數據定義、多個變量、多個函數,因此 DWARF 遵循這個模型,也是塊結構。DWARF 裏基本的描述項是調試信息項 DIE(Debugging Information Entry)。一個 DIE 有一個標籤,表示這個 DIE 描述了什麼以及一個填入了細節並進一步描述該項的屬性列表(類比 html、xml 結構)。一個 DIE(除了最頂層的)被一個父 DIE 包含,可能存在兄弟 DIE 或者子 DIE,屬性可能包含各類值:常量(好比一個函數名),變量(好比一個函數的起始地址),或對另外一個DIE的引用(好比一個函數的返回值類型)。
DWARF 文件中的數據以下:
數據列 | 信息說明 |
---|---|
.debug_loc | 在 DW_AT_location 屬性中使用的位置列表 |
.debug_macinfo | 宏信息 |
.debug_pubnames | 全局對象和函數的查找表 |
.debug_pubtypes | 全局類型的查找表 |
.debug_ranges | 在 DW_AT_ranges 屬性中使用的地址範圍 |
.debug_str | 在 .debug_info 中使用的字符串表 |
.debug_types | 類型描述 |
經常使用的標記與屬性以下:
數據列 | 信息說明 |
---|---|
DW_TAG_class_type | 表示類名稱和類型信息 |
DW_TAG_structure_type | 表示結構名稱和類型信息 |
DW_TAG_union_type | 表示聯合名稱和類型信息 |
DW_TAG_enumeration_type | 表示枚舉名稱和類型信息 |
DW_TAG_typedef | 表示 typedef 的名稱和類型信息 |
DW_TAG_array_type | 表示數組名稱和類型信息 |
DW_TAG_subrange_type | 表示數組的大小信息 |
DW_TAG_inheritance | 表示繼承的類名稱和類型信息 |
DW_TAG_member | 表示類的成員 |
DW_TAG_subprogram | 表示函數的名稱信息 |
DW_TAG_formal_parameter | 表示函數的參數信息 |
DW_TAG_name | 表示名稱字符串 |
DW_TAG_type | 表示類型信息 |
DW_TAG_artifical | 在建立時由編譯程序設置 |
DW_TAG_sibling | 表示兄弟位置信息 |
DW_TAG_data_memver_location | 表示位置信息 |
DW_TAG_virtuality | 在虛擬時設置 |
簡單看一個 DWARF 的例子:將測試工程的 .dSYM
文件夾下的 DWARF 文件用下面命令解析
dwarfdump -F --debug-info Test.app.dSYM/Contents/Resources/DWARF/Test > debug-info.txt
打開以下
Test.app.dSYM/Contents/Resources/DWARF/Test: file format Mach-O arm64 .debug_info contents: 0x00000000: Compile Unit: length = 0x0000004f version = 0x0004 abbr_offset = 0x0000 addr_size = 0x08 (next unit at 0x00000053) 0x0000000b: DW_TAG_compile_unit DW_AT_producer [DW_FORM_strp] ("Apple clang version 11.0.3 (clang-1103.0.32.62)") DW_AT_language [DW_FORM_data2] (DW_LANG_ObjC) DW_AT_name [DW_FORM_strp] ("_Builtin_stddef_max_align_t") DW_AT_stmt_list [DW_FORM_sec_offset] (0x00000000) DW_AT_comp_dir [DW_FORM_strp] ("/Users/lbp/Desktop/Test") DW_AT_APPLE_major_runtime_vers [DW_FORM_data1] (0x02) DW_AT_GNU_dwo_id [DW_FORM_data8] (0x392b5344d415340c) 0x00000027: DW_TAG_module DW_AT_name [DW_FORM_strp] ("_Builtin_stddef_max_align_t") DW_AT_LLVM_config_macros [DW_FORM_strp] ("\"-DDEBUG=1\" \"-DOBJC_OLD_DISPATCH_PROTOTYPES=1\"") DW_AT_LLVM_include_path [DW_FORM_strp] ("/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/clang/11.0.3/include") DW_AT_LLVM_isysroot [DW_FORM_strp] ("/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk") 0x00000038: DW_TAG_typedef DW_AT_type [DW_FORM_ref4] (0x0000004b "long double") DW_AT_name [DW_FORM_strp] ("max_align_t") DW_AT_decl_file [DW_FORM_data1] ("/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/clang/11.0.3/include/__stddef_max_align_t.h") DW_AT_decl_line [DW_FORM_data1] (16) 0x00000043: DW_TAG_imported_declaration DW_AT_decl_file [DW_FORM_data1] ("/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/clang/11.0.3/include/__stddef_max_align_t.h") DW_AT_decl_line [DW_FORM_data1] (27) DW_AT_import [DW_FORM_ref_addr] (0x0000000000000027) 0x0000004a: NULL 0x0000004b: DW_TAG_base_type DW_AT_name [DW_FORM_strp] ("long double") DW_AT_encoding [DW_FORM_data1] (DW_ATE_float) DW_AT_byte_size [DW_FORM_data1] (0x08) 0x00000052: NULL 0x00000053: Compile Unit: length = 0x000183dc version = 0x0004 abbr_offset = 0x0000 addr_size = 0x08 (next unit at 0x00018433) 0x0000005e: DW_TAG_compile_unit DW_AT_producer [DW_FORM_strp] ("Apple clang version 11.0.3 (clang-1103.0.32.62)") DW_AT_language [DW_FORM_data2] (DW_LANG_ObjC) DW_AT_name [DW_FORM_strp] ("Darwin") DW_AT_stmt_list [DW_FORM_sec_offset] (0x000000a7) DW_AT_comp_dir [DW_FORM_strp] ("/Users/lbp/Desktop/Test") DW_AT_APPLE_major_runtime_vers [DW_FORM_data1] (0x02) DW_AT_GNU_dwo_id [DW_FORM_data8] (0xa4a1d339379e18a5) 0x0000007a: DW_TAG_module DW_AT_name [DW_FORM_strp] ("Darwin") DW_AT_LLVM_config_macros [DW_FORM_strp] ("\"-DDEBUG=1\" \"-DOBJC_OLD_DISPATCH_PROTOTYPES=1\"") DW_AT_LLVM_include_path [DW_FORM_strp] ("/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include") DW_AT_LLVM_isysroot [DW_FORM_strp] ("/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk") 0x0000008b: DW_TAG_module DW_AT_name [DW_FORM_strp] ("C") DW_AT_LLVM_config_macros [DW_FORM_strp] ("\"-DDEBUG=1\" \"-DOBJC_OLD_DISPATCH_PROTOTYPES=1\"") DW_AT_LLVM_include_path [DW_FORM_strp] ("/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include") DW_AT_LLVM_isysroot [DW_FORM_strp] ("/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk") 0x0000009c: DW_TAG_module DW_AT_name [DW_FORM_strp] ("fenv") DW_AT_LLVM_config_macros [DW_FORM_strp] ("\"-DDEBUG=1\" \"-DOBJC_OLD_DISPATCH_PROTOTYPES=1\"") DW_AT_LLVM_include_path [DW_FORM_strp] ("/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include") DW_AT_LLVM_isysroot [DW_FORM_strp] ("/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk") 0x000000ad: DW_TAG_enumeration_type DW_AT_type [DW_FORM_ref4] (0x00017276 "unsigned int") DW_AT_byte_size [DW_FORM_data1] (0x04) DW_AT_decl_file [DW_FORM_data1] ("/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/fenv.h") DW_AT_decl_line [DW_FORM_data1] (154) 0x000000b5: DW_TAG_enumerator DW_AT_name [DW_FORM_strp] ("__fpcr_trap_invalid") DW_AT_const_value [DW_FORM_udata] (256) 0x000000bc: DW_TAG_enumerator DW_AT_name [DW_FORM_strp] ("__fpcr_trap_divbyzero") DW_AT_const_value [DW_FORM_udata] (512) 0x000000c3: DW_TAG_enumerator DW_AT_name [DW_FORM_strp] ("__fpcr_trap_overflow") DW_AT_const_value [DW_FORM_udata] (1024) 0x000000ca: DW_TAG_enumerator DW_AT_name [DW_FORM_strp] ("__fpcr_trap_underflow") // ...... 0x000466ee: DW_TAG_subprogram DW_AT_name [DW_FORM_strp] ("CFBridgingRetain") DW_AT_decl_file [DW_FORM_data1] ("/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/System/Library/Frameworks/Foundation.framework/Headers/NSObject.h") DW_AT_decl_line [DW_FORM_data1] (105) DW_AT_prototyped [DW_FORM_flag_present] (true) DW_AT_type [DW_FORM_ref_addr] (0x0000000000019155 "CFTypeRef") DW_AT_inline [DW_FORM_data1] (DW_INL_inlined) 0x000466fa: DW_TAG_formal_parameter DW_AT_name [DW_FORM_strp] ("X") DW_AT_decl_file [DW_FORM_data1] ("/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/System/Library/Frameworks/Foundation.framework/Headers/NSObject.h") DW_AT_decl_line [DW_FORM_data1] (105) DW_AT_type [DW_FORM_ref4] (0x00046706 "id") 0x00046705: NULL 0x00046706: DW_TAG_typedef DW_AT_type [DW_FORM_ref4] (0x00046711 "objc_object*") DW_AT_name [DW_FORM_strp] ("id") DW_AT_decl_file [DW_FORM_data1] ("/Users/lbp/Desktop/Test/Test/NetworkAPM/NSURLResponse+cm_FetchStatusLineFromCFNetwork.m") DW_AT_decl_line [DW_FORM_data1] (44) 0x00046711: DW_TAG_pointer_type DW_AT_type [DW_FORM_ref4] (0x00046716 "objc_object") 0x00046716: DW_TAG_structure_type DW_AT_name [DW_FORM_strp] ("objc_object") DW_AT_byte_size [DW_FORM_data1] (0x00) 0x0004671c: DW_TAG_member DW_AT_name [DW_FORM_strp] ("isa") DW_AT_type [DW_FORM_ref4] (0x00046727 "objc_class*") DW_AT_data_member_location [DW_FORM_data1] (0x00) // ......
這裏就不粘貼所有內容了(太長了)。能夠看到 DIE 包含了函數開始地址、結束地址、函數名、文件名、所在行數,對於給定的地址,找到函數開始地址、結束地址之間包含該抵制的 DIE,則能夠還原函數名和文件名信息。
debug_line 能夠還原文件行數等信息
dwarfdump -F --debug-line Test.app.dSYM/Contents/Resources/DWARF/Test > debug-inline.txt
貼部分信息
Test.app.dSYM/Contents/Resources/DWARF/Test: file format Mach-O arm64 .debug_line contents: debug_line[0x00000000] Line table prologue: total_length: 0x000000a3 version: 4 prologue_length: 0x0000009a min_inst_length: 1 max_ops_per_inst: 1 default_is_stmt: 1 line_base: -5 line_range: 14 opcode_base: 13 standard_opcode_lengths[DW_LNS_copy] = 0 standard_opcode_lengths[DW_LNS_advance_pc] = 1 standard_opcode_lengths[DW_LNS_advance_line] = 1 standard_opcode_lengths[DW_LNS_set_file] = 1 standard_opcode_lengths[DW_LNS_set_column] = 1 standard_opcode_lengths[DW_LNS_negate_stmt] = 0 standard_opcode_lengths[DW_LNS_set_basic_block] = 0 standard_opcode_lengths[DW_LNS_const_add_pc] = 0 standard_opcode_lengths[DW_LNS_fixed_advance_pc] = 1 standard_opcode_lengths[DW_LNS_set_prologue_end] = 0 standard_opcode_lengths[DW_LNS_set_epilogue_begin] = 0 standard_opcode_lengths[DW_LNS_set_isa] = 1 include_directories[ 1] = "/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/clang/11.0.3/include" file_names[ 1]: name: "__stddef_max_align_t.h" dir_index: 1 mod_time: 0x00000000 length: 0x00000000 Address Line Column File ISA Discriminator Flags ------------------ ------ ------ ------ --- ------------- ------------- 0x0000000000000000 1 0 1 0 0 is_stmt end_sequence debug_line[0x000000a7] Line table prologue: total_length: 0x0000230a version: 4 prologue_length: 0x00002301 min_inst_length: 1 max_ops_per_inst: 1 default_is_stmt: 1 line_base: -5 line_range: 14 opcode_base: 13 standard_opcode_lengths[DW_LNS_copy] = 0 standard_opcode_lengths[DW_LNS_advance_pc] = 1 standard_opcode_lengths[DW_LNS_advance_line] = 1 standard_opcode_lengths[DW_LNS_set_file] = 1 standard_opcode_lengths[DW_LNS_set_column] = 1 standard_opcode_lengths[DW_LNS_negate_stmt] = 0 standard_opcode_lengths[DW_LNS_set_basic_block] = 0 standard_opcode_lengths[DW_LNS_const_add_pc] = 0 standard_opcode_lengths[DW_LNS_fixed_advance_pc] = 1 standard_opcode_lengths[DW_LNS_set_prologue_end] = 0 standard_opcode_lengths[DW_LNS_set_epilogue_begin] = 0 standard_opcode_lengths[DW_LNS_set_isa] = 1 include_directories[ 1] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include" include_directories[ 2] = "/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/clang/11.0.3/include" include_directories[ 3] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/sys" include_directories[ 4] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/mach" include_directories[ 5] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/libkern" include_directories[ 6] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/architecture" include_directories[ 7] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/sys/_types" include_directories[ 8] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/_types" include_directories[ 9] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/arm" include_directories[ 10] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/sys/_pthread" include_directories[ 11] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/mach/arm" include_directories[ 12] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/libkern/arm" include_directories[ 13] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/uuid" include_directories[ 14] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/netinet" include_directories[ 15] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/netinet6" include_directories[ 16] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/net" include_directories[ 17] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/pthread" include_directories[ 18] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/mach_debug" include_directories[ 19] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/os" include_directories[ 20] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/malloc" include_directories[ 21] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/bsm" include_directories[ 22] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/machine" include_directories[ 23] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/mach/machine" include_directories[ 24] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/secure" include_directories[ 25] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/xlocale" include_directories[ 26] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/arpa" file_names[ 1]: name: "fenv.h" dir_index: 1 mod_time: 0x00000000 length: 0x00000000 file_names[ 2]: name: "stdatomic.h" dir_index: 2 mod_time: 0x00000000 length: 0x00000000 file_names[ 3]: name: "wait.h" dir_index: 3 mod_time: 0x00000000 length: 0x00000000 // ...... Address Line Column File ISA Discriminator Flags ------------------ ------ ------ ------ --- ------------- ------------- 0x000000010000b588 14 0 2 0 0 is_stmt 0x000000010000b5b4 16 5 2 0 0 is_stmt prologue_end 0x000000010000b5d0 17 11 2 0 0 is_stmt 0x000000010000b5d4 0 0 2 0 0 0x000000010000b5d8 17 5 2 0 0 0x000000010000b5dc 17 11 2 0 0 0x000000010000b5e8 18 1 2 0 0 is_stmt 0x000000010000b608 20 0 2 0 0 is_stmt 0x000000010000b61c 22 5 2 0 0 is_stmt prologue_end 0x000000010000b628 23 5 2 0 0 is_stmt 0x000000010000b644 24 1 2 0 0 is_stmt 0x000000010000b650 15 0 1 0 0 is_stmt 0x000000010000b65c 15 41 1 0 0 is_stmt prologue_end 0x000000010000b66c 11 0 2 0 0 is_stmt 0x000000010000b680 11 17 2 0 0 is_stmt prologue_end 0x000000010000b6a4 11 17 2 0 0 is_stmt end_sequence debug_line[0x0000def9] Line table prologue: total_length: 0x0000015a version: 4 prologue_length: 0x000000eb min_inst_length: 1 max_ops_per_inst: 1 default_is_stmt: 1 line_base: -5 line_range: 14 opcode_base: 13 standard_opcode_lengths[DW_LNS_copy] = 0 standard_opcode_lengths[DW_LNS_advance_pc] = 1 standard_opcode_lengths[DW_LNS_advance_line] = 1 standard_opcode_lengths[DW_LNS_set_file] = 1 standard_opcode_lengths[DW_LNS_set_column] = 1 standard_opcode_lengths[DW_LNS_negate_stmt] = 0 standard_opcode_lengths[DW_LNS_set_basic_block] = 0 standard_opcode_lengths[DW_LNS_const_add_pc] = 0 standard_opcode_lengths[DW_LNS_fixed_advance_pc] = 1 standard_opcode_lengths[DW_LNS_set_prologue_end] = 0 standard_opcode_lengths[DW_LNS_set_epilogue_begin] = 0 standard_opcode_lengths[DW_LNS_set_isa] = 1 include_directories[ 1] = "Test" include_directories[ 2] = "Test/NetworkAPM" include_directories[ 3] = "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS13.5.sdk/usr/include/objc" file_names[ 1]: name: "AppDelegate.h" dir_index: 1 mod_time: 0x00000000 length: 0x00000000 file_names[ 2]: name: "JMWebResourceURLProtocol.h" dir_index: 2 mod_time: 0x00000000 length: 0x00000000 file_names[ 3]: name: "AppDelegate.m" dir_index: 1 mod_time: 0x00000000 length: 0x00000000 file_names[ 4]: name: "objc.h" dir_index: 3 mod_time: 0x00000000 length: 0x00000000 // ......
能夠看到 debug_line 裏包含了每一個代碼地址對應的行數。上面貼了 AppDelegate 的部分。
在連接中,咱們將函數和變量統稱爲符合(Symbol),函數名或變量名就是符號名(Symbol Name),咱們能夠將符號當作是連接中的粘合劑,整個連接過程正是基於符號才能正確完成的。
上述文字來自《程序員的自我修養》。因此符號就是函數、變量、類的統稱。
按照類型劃分,符號能夠分爲三類:
符號表(Symbol Table):是內存地址與函數名、文件名、行號的映射表。每一個定義的符號都有一個對應的值得,叫作符號值(Symbol Value),對於變量和函數來講,符號值就是地址,符號表組成以下
<起始地址> <結束地址> <函數> [<文件名:行號>]
image 加載的時候會進行相對基地址進行重定位,而且每次加載的基地址都不同,函數棧 frame 的地址是重定位後的絕對地址,咱們要的是重定位前的相對地址。
Binary Images
拿測試工程的 crash 日誌舉例子,打開貼部分 Binary Images 內容
// ... Binary Images: 0x102fe0000 - 0x102ff3fff Test arm64 <37eaa57df2523d95969e47a9a1d69ce5> /var/containers/Bundle/Application/643F0DFE-A710-4136-A278-A89D780B7208/Test.app/Test 0x1030e0000 - 0x1030ebfff libobjc-trampolines.dylib arm64 <181f3aa866d93165ac54344385ac6e1d> /usr/lib/libobjc-trampolines.dylib 0x103204000 - 0x103267fff dyld arm64 <6f1c86b640a3352a8529bca213946dd5> /usr/lib/dyld 0x189a78000 - 0x189a8efff libsystem_trace.dylib arm64 <b7477df8f6ab3b2b9275ad23c6cc0b75> /usr/lib/system/libsystem_trace.dylib // ...
能夠看到 Crash 日誌的 Binary Images 包含每一個 Image 的加載開始地址、結束地址、image 名稱、arm 架構、uuid、image 路徑。
crash 日誌中的信息
Last Exception Backtrace: // ... 5 Test 0x102fe592c -[ViewController testMonitorCrash] + 22828 (ViewController.mm:58)
Binary Images: 0x102fe0000 - 0x102ff3fff Test arm64 <37eaa57df2523d95969e47a9a1d69ce5> /var/containers/Bundle/Application/643F0DFE-A710-4136-A278-A89D780B7208/Test.app/Test
因此 frame 5 的相對地址爲 0x102fe592c - 0x102fe0000
。再使用 命令能夠還原符號信息。
使用 atos 來解析,0x102fe0000
爲 image 加載的開始地址,0x102fe592c
爲 frame 須要還原的地址。
atos -o Test.app.dSYM/Contents/Resources/DWARF/Test-arch arm64 -l 0x102fe0000 0x102fe592c
crash 文件的 UUID
grep --after-context=2 "Binary Images:" *.crash
Test 5-28-20, 7-47 PM.crash:Binary Images: Test 5-28-20, 7-47 PM.crash-0x102fe0000 - 0x102ff3fff Test arm64 <37eaa57df2523d95969e47a9a1d69ce5> /var/containers/Bundle/Application/643F0DFE-A710-4136-A278-A89D780B7208/Test.app/Test Test 5-28-20, 7-47 PM.crash-0x1030e0000 - 0x1030ebfff libobjc-trampolines.dylib arm64 <181f3aa866d93165ac54344385ac6e1d> /usr/lib/libobjc-trampolines.dylib -- Test.crash:Binary Images: Test.crash-0x102fe0000 - 0x102ff3fff Test arm64 <37eaa57df2523d95969e47a9a1d69ce5> /var/containers/Bundle/Application/643F0DFE-A710-4136-A278-A89D780B7208/Test.app/Test Test.crash-0x1030e0000 - 0x1030ebfff libobjc-trampolines.dylib arm64 <181f3aa866d93165ac54344385ac6e1d> /usr/lib/libobjc-trampolines.dylib
Test App 的 UUID 爲 37eaa57df2523d95969e47a9a1d69ce5
.
.dSYM 文件的 UUID
dwarfdump --uuid Test.app.dSYM
結果爲
UUID: 37EAA57D-F252-3D95-969E-47A9A1D69CE5 (arm64) Test.app.dSYM/Contents/Resources/DWARF/Test
app 的 UUID
dwarfdump --uuid Test.app/Test
結果爲
UUID: 37EAA57D-F252-3D95-969E-47A9A1D69CE5 (arm64) Test.app/Test
上述篇幅分析瞭如何捕獲各類類型的 crash,App 在用戶手中咱們經過技術手段能夠獲取 crash 案發現場信息並結合必定的機制去上報,可是這種堆棧是十六進制的地址,沒法定位問題,因此須要作符號化處理。
上面也說明了.dSYM 文件 的做用,經過符號地址結合 dSYM 文件來還原文件名、所在行、函數名,這個過程叫符號化。可是 .dSYM 文件必須和 crash log 文件的 bundle id、version 嚴格對應。
獲取 Crash 日誌能夠經過 Xcode -> Window -> Devices and Simulators 選擇對應設備,找到 Crash 日誌文件,根據時間和 App 名稱定位。
app 和 .dSYM 文件能夠經過打包的產物獲得,路徑爲 ~/Library/Developer/Xcode/Archives
。
解析方法通常有2種:
使用 symbolicatecrash
symbolicatecrash 是 Xcode 自帶的 crash 日誌分析工具,先肯定所在路徑,在終端執行下面的命令
find /Applications/Xcode.app -name symbolicatecrash -type f
會返回幾個路徑,找到 iPhoneSimulator.platform
所在那一行
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/Library/PrivateFrameworks/DVTFoundation.framework/symbolicatecrash
將 symbolicatecrash 拷貝到指定文件夾下(保存了 app、dSYM、crash 文件的文件夾)
執行命令
./symbolicatecrash Test.crash Test.dSYM > Test.crash
第一次作這事兒應該會報錯 Error: "DEVELOPER_DIR" is not defined at ./symbolicatecrash line 69.
,解決方案:在終端執行下面命令
export DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer
使用 atos
區別於 symbolicatecrash,atos 較爲靈活,只要 .crash
和 .dSYM
或者 .crash
和 .app
文件對應便可。
用法以下,-l 最後跟得是符號地址
xcrun atos -o Test.app.dSYM/Contents/Resources/DWARF/Test -arch armv7 -l 0x1023c592c
也能夠解析 .app 文件(不存在 .dSYM 文件),其中xxx爲段地址,xx爲偏移地址
atos -arch architecture -o binary -l xxx xx
由於咱們的 App 可能有不少,每一個 App 在用戶手中多是不一樣的版本,因此在 APM 攔截以後須要符號化的時候須要將 crash 文件和 .dSYM
文件一一對應,才能正確符號化,對應的原則就是 UUID 一致。
咱們每次真機鏈接 Xcode 運行程序,會提示等待,其實系統爲了堆棧解析,都會把當前版本的系統符號庫自動導入到 /Users/你本身的用戶名/Library/Developer/Xcode/iOS DeviceSupport
目錄下安裝了一大堆系統庫的符號化文件。你能夠訪問下面目錄看看
/Users/你本身的用戶名/Library/Developer/Xcode/iOS DeviceSupport/
業界設計日誌監控系統通常會採用基於 ELK 技術。ELK 是 Elasticsearch、Logstash、Kibana 三個開源框架縮寫。Elasticsearch 是一個分佈式、經過 Restful 方式進行交互的近實時搜索的平臺框架。Logstash 是一箇中央數據流引擎,用於從不一樣目標(文件/數據存儲/MQ)收集不一樣格式的數據,通過過濾後支持輸出到不一樣目的地(文件/MQ/Redis/ElasticsSearch/Kafka)。Kibana 能夠將 Elasticserarch 的數據經過友好的頁面展現出來,提供可視化分析功能。因此 ELK 能夠搭建一個高效、企業級的日誌分析系統。
早期單體應用時代,幾乎應用的全部功能都在一臺機器上運行,出了問題,運維人員打開終端輸入命令直接查看系統日誌,進而定位問題、解決問題。隨着系統的功能愈來愈複雜,用戶體量愈來愈大,單體應用幾乎很難知足需求,因此技術架構迭代了,經過水平拓展來支持龐大的用戶量,將單體應用進行拆分爲多個應用,每一個應用採用集羣方式部署,負載均衡控制調度,假如某個子模塊發生問題,去找這臺服務器上終端找日誌分析嗎?顯然臺落後,因此日誌管理平臺便應運而生。經過 Logstash 去收集分析每臺服務器的日誌文件,而後按照定義的正則模版過濾後傳輸到 Kafka 或 Redis,而後由另外一個 Logstash 從 Kafka 或 Redis 上讀取日誌存儲到 ES 中建立索引,最後經過 Kibana 進行可視化分析。此外能夠將收集到的數據進行數據分析,作更進一步的維護和決策。
上圖展現了一個 ELK 的日誌架構圖。簡單說明下:
下圖貼一個 Elasticsearch 社區分享的一個 「Elastic APM 動手實戰」主題的內容截圖。
Crash log 統一入庫 Kibana 時是沒有符號化的,因此須要符號化處理,以方便定位問題、crash 產生報表和後續處理。
因此整個流程就是:客戶端 APM SDK 收集 crash log -> Kafka 存儲 -> Mac 機執行定時任務符號化 -> 數據回傳 Kafka -> 產品側(顯示端)對數據進行分類、報表、報警等操做。
由於公司的產品線有多條,相應的 App 有多個,用戶使用的 App 版本也各不相同,因此 crash 日誌分析必需要有正確的 .dSYM 文件,那麼多 App 的不一樣版本,自動化就變得很是重要了。
自動化有2種手段,規模小一點的公司或者圖省事,能夠在 Xcode中 添加 runScript 腳本代碼來自動在 release 模式下上傳dSYM)。
由於咱們公司有本身的一套體系,wax-cli,能夠同時管理 iOS SDK、iOS App、Android SDK、Android App、Node、React、React Native 工程項目的初始化、依賴管理、構建(持續集成、Unit Test、Lint、統跳檢測)、測試、打包、部署、動態能力(熱更新、統跳路由下發)等能力於一身。能夠基於各個階段作能力的插入,因此能夠在調用打包後在打包機上傳 .dSYM 文件到七牛雲存儲(規則能夠是以 AppName + Version 爲 key,value 爲 .dSYM 文件)。
如今不少架構設計都是微服務,至於爲何選微服務,不在本文範疇。因此 crash 日誌的符號化被設計爲一個微服務。架構圖以下
說明:
其中符號化服務是大前端背景下大前端團隊的產物,因此是 NodeJS 實現的。iOS 的符號化機器是 雙核的 Mac mini,這就須要作實驗測評到底須要開啓幾個 worker 進程作符號化服務。結果是雙進程處理 crash log,比單進程效率高近一倍,而四進程比雙進程效率提高不明顯,符合雙核 mac mini 的特色。因此開啓兩個 worker 進程作符號化處理。
下圖是完整設計圖
簡單說明下,符號化流程是一個主從模式,一臺 master 機,多個 slave 機,master 機讀取 .dSYM 和 crash 結果的 cache。mass 調度符號化服務(內部2個 symbolocate worker)同時從七牛雲上獲取 .dSYM 文件。
系統架構圖以下
整個 APM 的架構圖以下
說明: