ThreadStacksC/C++ 進(jìn)程堆棧追蹤庫
ThreadStacks 可用于檢查與 ThreadStacks 庫鏈接的活動進(jìn)程的所有線程。粗略地說,ThreadStacks 為C / C ++ 程序提供了相當(dāng)于 Golang 的 runtime.Stack()。除了編程訪問堆棧跟蹤之外,ThreadStacks 還提供了 jmap 樣式實用程序,其中 kill -35 可用于讓實時進(jìn)程將其所有線程的堆棧跟蹤寫入 stderr。
ThreadStacks 是適用于測試和生產(chǎn)環(huán)境的主要調(diào)試工具,它幫助調(diào)試堆棧中某些最關(guān)鍵服務(wù)的各種問題,包括內(nèi)存數(shù)據(jù)庫和集群管理器。
設(shè)計思路
以下步驟來收集線程的堆棧跟蹤:
-
找到正在運行的線程列表(T1,T2,T3)。這是通過讓'/ proc / self / task'目錄的子目錄完成的。
-
為每個線程分配一個內(nèi)存插槽以寫入其堆棧跟蹤(M1,M2,M3)。請注意,從信號處理程序分配內(nèi)存不是異步信號安全的,因此預(yù)先分配內(nèi)存。
-
發(fā)送實時信號給每個發(fā)現(xiàn)的線程并等待他們的應(yīng)答。相應(yīng)的存儲器插槽和ack文件描述符是實時信號有效負(fù)載的一部分。
-
線程的信號處理程序使用 libunwind 來計算它們的堆棧跟蹤,并在各自的內(nèi)存插槽中寫入基于原始指令指針的堆棧跟蹤。
-
在將堆棧跟蹤寫入指定的內(nèi)存插槽后,每個線程都會通過管道回退到收集器線程。
-
在接收到所有 acks(與步驟#1中檢測到的線程數(shù)相同)后,收集器線程將對棧跟蹤進(jìn)行唯一化和符號化。
使用
進(jìn)程可以鏈接到 ThreadStacks 庫并安裝'StackTraceSignal'類中定義的兩個信號處理程序,以便能夠?qū)崟r檢查其堆棧跟蹤:
thoughtspot::StackTraceSignal::InstallInternalHandler() thoughtspot::StackTraceSignal::InstallExternalHandler()
在安裝了上述兩個信號處理器之后,'StackTraceCollector'類可以用來收集堆棧跟蹤,例如,來自REST處理程序。
構(gòu)建
ThreadStacks 使用 bazel 作為其構(gòu)建系統(tǒng),并依賴于'glog'、'gflags'和'googletests'項目作為遠(yuǎn)程 bazel 項目。
bazel build //threadstacks/...
測試:
bazel test //...
