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] で、最後の2つはネストされたグループ化を提供します。
• 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つの命令ポインタがメタデータと2つのNULL終了マーカーを保存するために使用されることに注意してください。現在の設定は、引数なしでこの関数を呼び出すことで取得でき、各設定はキーワードを使用するか、または (n, delay) の順序で独立して設定できます。

fetch(;include_meta = true) -> data

プロファイルバックトレースのバッファのコピーを返します。data内の値は、JITコンパイルで使用される正確なメモリアドレスに依存するため、現在のセッションのこのマシンでのみ意味があります。この関数は主に内部使用のためのものであり、ほとんどのユーザーにはretrieveの方が良い選択かもしれません。デフォルトでは、threadidやtaskidなどのメタデータが含まれています。メタデータを削除するには、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 ビューアーが期待する JSON 形式でファイル（デフォルトでは現在のディレクトリに $pid_$timestamp.heapsnapshot という名前で、現在のディレクトリが書き込み不可の場合は tempdir に）に書き込みます。指定された場合は dir に、または指定されたフルファイルパス、または IO ストリームに書き込むこともできます。

all_one が true の場合、すべてのオブジェクトのサイズを 1 として報告し、簡単にカウントできるようにします。そうでない場合は、実際のサイズを報告します。

streaming が true の場合、スナップショットデータを 4 つのファイルにストリーミングし、ファイルパスをプレフィックスとして使用します。これにより、全体のスナップショットをメモリに保持する必要がなくなります。このオプションは、メモリが制約されている設定で使用する必要があります。これらのファイルは、Profile.HeapSnapshot.assemble_snapshot() を呼び出すことで再構成できます。これはオフラインで行うことができます。

注意: パフォーマンスの理由から、streaming=true を設定することを強くお勧めします。部分からスナップショットを再構成するには、全体のスナップショットをメモリに保持する必要があるため、スナップショットが大きい場合、処理中にメモリが不足する可能性があります。ストリーミングを使用すると、ワークロードの実行が完了した後にオフラインでスナップショットを再構成できます。streaming=false（デフォルト、後方互換性のため）でスナップショットを収集しようとし、プロセスが終了した場合、提供されたファイルパスと同じディレクトリに常に部分が保存されるため、後で assemble_snapshot() を介してスナップショットを再構成できます。