剖析

@profile

@profile <expression> 在執行表達式的同時，定期擷取回溯。這些回溯會附加到回溯的內部緩衝區。

clear()

清除內部緩衝區中任何現有的回溯。

print([io::IO = stdout,] [data::Vector = fetch()], [lidict::Union{LineInfoDict, LineInfoFlatDict} = getdict(data)]; kwargs...)

將剖析結果列印到 io (預設為 stdout)。如果您未提供 data 向量，將使用累積回溯的內部緩衝區。

關鍵字引數可以是下列任何組合

• format – 決定回溯是否以 (預設為 :tree) 或不帶 (:flat) 縮排列印，以表示樹狀結構。

• C – 如果為 true，將顯示 C 和 Fortran 程式碼的回溯 (通常會排除)。

• combine – 如果為 true (預設)，將合併對應到程式碼同一行的指令指標。

• maxdepth – 限制 :tree 格式中大於 maxdepth 的深度。

• sortedby – 控制 :flat 格式中的順序。:filefuncline (預設) 依據原始碼行排序，:count 依據收集的樣本數量排序，而 :overhead 則依據每個函數本身產生的樣本數量排序。

• groupby – 控制依據任務和執行緒進行分組，或不分組。選項有 :none (預設)、:thread、:task、[:thread, :task] 或 [:task, :thread]，其中最後兩個提供巢狀分組。

• noisefloor – 限制超過樣本啟發式雜訊層的框架（僅適用於格式 :tree）。建議嘗試的值為 2.0（預設值為 0）。此參數會隱藏 n <= noisefloor * √N 的樣本，其中 n 是此列上的樣本數，而 N 是呼叫者的樣本數。

• mincount – 將列印輸出限制為僅包含至少有 mincount 次發生的列。

• recur – 控制 :tree 格式中的遞迴處理。:off（預設值）會正常列印樹狀結構。:flat 則會壓縮任何遞迴（依 ip），顯示將任何自我遞迴轉換為迭代器的近似效果。:flatc 會執行相同的動作，但也會包含 C 框架的摺疊（可能在 jl_apply 附近執行奇怪的動作）。

• threads::Union{Int,AbstractVector{Int}} – 指定要包含在報告中的快照執行緒。請注意，這不會控制收集樣本的執行緒（也可能在另一台機器上收集）。

• tasks::Union{Int,AbstractVector{Int}} – 指定要包含在報告中的快照工作。請注意，這不會控制收集樣本的工作。

print([io::IO = stdout,] data::Vector, lidict::LineInfoDict; kwargs...)

將剖析結果列印到 io。此變體用於檢查先前呼叫 retrieve 匯出的結果。提供反向追蹤的向量 data 和行資訊的字典 lidict。

請參閱 Profile.print([io], data) 以了解有效的關鍵字參數說明。

init(; n::Integer, delay::Real)

設定回溯之間的延遲（以秒為單位），以及每個執行緒可以儲存的指令指標數量n。每個指令指標對應到程式碼的一行；回溯通常包含一個很長的指令指標清單。請注意，每個回溯的指令指標有 6 個空白用於儲存元資料和兩個 NULL 結束標記。目前的設定可以透過呼叫此函數（不帶任何參數）取得，而且每個設定都可以使用關鍵字或依序使用 (n, delay) 獨立設定。

fetch(;include_meta = true) -> data

傳回剖析回溯緩衝區的副本。請注意，data 中的值僅在此機器和目前的階段有意義，因為它取決於 JIT 編譯中使用的精確記憶體位址。此函數主要供內部使用；retrieve 可能對大部分使用者來說是更好的選擇。預設會包含執行緒 ID 和任務 ID 等元資料。將 include_meta 設定為 false 以移除元資料。

retrieve(; kwargs...) -> data, lidict

以可攜式格式「匯出」剖析結果，傳回所有回溯的集合（data）和一個字典，將 data 中的（特定於階段的）指令指標對應到儲存檔案名稱、函數名稱和行號的 LineInfo 值。此函數讓您可以儲存剖析結果以供未來分析。

callers(funcname, [data, lidict], [filename=<filename>], [linerange=<start:stop>]) -> Vector{Tuple{count, lineinfo}}

給定先前的剖析執行，判斷誰呼叫特定函數。提供檔案名稱（以及函數定義範圍內的行號，可選擇），可以消除重載方法的歧義。傳回值是向量，包含呼叫次數和呼叫者行資訊。可以選擇提供從 retrieve 取得的回溯追蹤 data；否則，將使用目前的內部剖析緩衝區。

clear_malloc_data()

使用 --track-allocation 執行 Julia 時，清除任何儲存的記憶體配置資料。執行要測試的命令（強制 JIT 編譯），然後呼叫 clear_malloc_data。然後再次執行命令，退出 Julia，並檢查產生的 *.mem 檔案。

get_peek_duration()

取得剖析「窺視」的持續時間（秒），該「窺視」會透過 SIGINFO 或 SIGUSR1 觸發，具體取決於平台。

set_peek_duration(t::Float64)

設定剖析「窺視」的持續時間（秒），該「窺視」會透過 SIGINFO 或 SIGUSR1 觸發，具體取決於平台。

Profile.Allocs.@profile [sample_rate=0.1] expr

剖析 expr 期間發生的配置，傳回結果和 AllocResults 結構。

取樣率 1.0 會記錄所有內容；0.0 則不會記錄任何內容。

julia> Profile.Allocs.@profile sample_rate=0.01 peakflops()
1.03733270279065e11

julia> results = Profile.Allocs.fetch()

julia> last(sort(results.allocs, by=x->x.size))
Profile.Allocs.Alloc(Vector{Any}, Base.StackTraces.StackFrame[_new_array_ at array.c:127, ...], 5576)

目前使用 PProf.jl 套件，透過呼叫 PProf.Allocs.pprof，是視覺化這些內容的最佳方式。

Profile.Allocs.clear()

從記憶體中清除所有先前剖析的配置資訊。

Profile.Allocs.fetch()

擷取已記錄的配置，並將其解碼為可分析的 Julia 物件。

Profile.Allocs.start(sample_rate::Real)

開始記錄配置，取樣率為給定值。取樣率 1.0 會記錄所有內容；0.0 則不會記錄任何內容。

Profile.Allocs.stop()

停止記錄配置。

Profile.take_heap_snapshot(io::IOStream, all_one::Bool=false)
Profile.take_heap_snapshot(filepath::String, all_one::Bool=false)
Profile.take_heap_snapshot(all_one::Bool=false; dir::String)

將堆快照寫入 JSON 格式檔案（預設為目前的目錄中的 $pid_$timestamp.heapsnapshot）（或如果目前的目錄無法寫入，則寫入 tempdir），或寫入 dir（如果已提供）或指定的完整檔案路徑，或 IO 串流。

如果 all_one 為 true，則將每個物件的大小報告為 1，以便輕鬆計算。否則，報告實際大小。