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

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