Profiling

@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)

配置回溯之间的 delay（以秒为单位）和每个线程可以存储的指令指针数量 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 触发的 "peek" 配置文件的持续时间（以秒为单位），具体取决于平台。

set_peek_duration(t::Float64)

设置通过 SIGINFO 或 SIGUSR1 触发的 "peek" 配置文件的持续时间（以秒为单位），具体取决于平台。

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)

有关更多信息，请参阅 Julia 文档中的分析教程。

Profile.Allocs.clear()

清除内存中所有先前分析的分配信息。

Profile.Allocs.print([io::IO = stdout,] [data::AllocResults = fetch()]; kwargs...)

将分析结果打印到 io（默认情况下为 stdout）。如果您不提供 data 向量，将使用累积回溯的内部缓冲区。

有关有效关键字参数的解释，请参见 Profile.print。

Profile.Allocs.fetch()

获取记录的分配，并将其解码为可以分析的Julia对象。

Profile.Allocs.start(sample_rate::Real)

开始以给定的采样率记录分配。采样率为 1.0 将记录所有内容；0.0 将不记录任何内容。

Profile.Allocs.stop()

停止记录分配。

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

写入堆的快照，格式为 Chrome Devtools Heap Snapshot viewer 所期望的 JSON 格式（.heapsnapshot 扩展名），默认情况下将其写入当前目录中的文件（$pid_$timestamp.heapsnapshot）（如果当前目录不可写，则写入 tempdir），或者写入给定的 dir，或者给定的完整文件路径，或 IO 流。

如果 all_one 为 true，则将每个对象的大小报告为 1，以便于计数。否则，报告实际大小。

如果 streaming 为 true，我们将把快照数据流式输出到四个文件中，使用 filepath 作为前缀，以避免将整个快照保存在内存中。此选项应在内存受限的情况下使用。这些文件可以通过调用 Profile.HeapSnapshot.assemble_snapshot() 进行重新组装，这可以在离线时完成。

注意：我们强烈建议出于性能原因将 streaming=true。根据部分重建快照需要将整个快照保存在内存中，因此如果快照很大，处理时可能会耗尽内存。流式传输允许您在工作负载完成后离线重建快照。如果您尝试在 streaming=false（默认情况下，为了向后兼容）时收集快照，并且您的进程被终止，请注意，这将始终将部分保存到您提供的文件路径相同的目录中，因此您仍然可以通过 assemble_snapshot() 在事后重建快照。