Профилирование

@profile

@profile <expression> выполняет ваше выражение, делая периодические снимки стека вызовов. Они добавляются во внутренний буфер снимков стека вызовов.

clear()

Очистить любые существующие снимки стека вызовов из внутреннего буфера.

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

Выводит результаты профилирования в io (по умолчанию, stdout). Если вы не предоставите вектор data, будет использован внутренний буфер накопленных снимков стека вызовов.

Ключевые аргументы могут быть любой комбинацией:

• format – Определяет, выводятся ли снимки стека вызовов с (по умолчанию, :tree) или без (:flat) отступов, показывающих структуру дерева.

• C – Если true, показываются снимки стека вызовов из кода C и Fortran (обычно они исключаются).

• combine – Если true (по умолчанию), указатели инструкций объединяются, которые соответствуют одной и той же строке кода.

• maxdepth – Ограничивает глубину, превышающую maxdepth в формате :tree.

• sortedby – Управляет порядком в формате :flat. :filefuncline (по умолчанию) сортирует по строке исходного кода, :count сортирует по количеству собранных выборок, а :overhead сортирует по количеству выборок, полученных каждой функцией самостоятельно.

• noisefloor – Ограничивает кадры, которые превышают эвристическую порог шума выборки (применяется только к формату :tree). Рекомендуемое значение для этого параметра равно 2.0 (по умолчанию 0). Этот параметр скрывает выборки, для которых n <= noisefloor * √N, где n - количество выборок в этой строке, а N - количество выборок для вызываемой функции.

• mincount – Ограничивает вывод только теми строками, в которых есть по крайней мере mincount вхождений.

• recur – Управляет обработкой рекурсии в формате :tree. :off (по умолчанию) выводит дерево как обычно. :flat вместо этого сжимает любую рекурсию (по ip), показывая приблизительный эффект преобразования любой саморекурсии в итератор. :flatc делает то же самое, но также включает сжатие кадров C (может делать странные вещи вокруг jl_apply).

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

Выводит результаты профилирования в io. Эта версия используется для изучения результатов, экспортированных предыдущим вызовом retrieve. Укажите вектор data снимков стека вызовов и словарь lidict информации о строках.

См. Profile.print([io], data) для объяснения допустимых ключевых аргументов.

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

Настройте интервал delay между снимками стека вызовов (в секундах) и количество n указателей инструкций, которые могут быть сохранены. Каждый указатель инструкции соответствует одной строке кода; снимки стека вызовов, как правило, содержат большой список указателей инструкций. Значения по умолчанию можно получить, вызвав эту функцию без аргументов, и каждое из них можно установить независимо, используя ключевые слова или в порядке (n, delay).

fetch() -> data

Возвращает копию буфера профилирования снимков стека вызовов. Обратите внимание, что значения в data имеют смысл только на этом компьютере в текущем сеансе, так как зависят от точных адресов памяти, используемых при JIT-компиляции. Эта функция предназначена в основном для внутреннего использования; retrieve может быть лучшим выбором для большинства пользователей.

retrieve() -> data, lidict

«Экспортирует» результаты профилирования в переносимый формат, возвращая набор всех снимков стека вызовов (data) и словарь, который сопоставляет (специфичные для сеанса) указатели инструкций в data значениям LineInfo, которые хранят имя файла, имя функции и номер строки. Эта функция позволяет сохранить результаты профилирования для дальнейшего анализа.

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

Учитывая предыдущий запуск профилирования, определите, кто вызвал конкретную функцию. Предоставление имени файла (и, необязательно, диапазона номеров строк, в которых определена функция) позволяет разобрать перегруженную функцию. Возвращаемое значение — это вектор, содержащий количество вызовов и информацию о строке вызывающей функции. Можно необязательно предоставить снимок стека вызовов data, полученный из retrieve; в противном случае используется текущий внутренний буфер профилирования.

clear_malloc_data()

Очищает любые сохранённые данные о выделении памяти при запуске julia с --track-allocation. Выполните команду(ы), которую(ые) вы хотите протестировать (чтобы принудительно выполнить JIT-компиляцию), а затем вызовите clear_malloc_data. Затем снова выполните свои команду(ы), выйдите из Julia и просмотрите полученные *.mem файлы.