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

AI-справочник по таймингам MiniProfiler, захватам JetBrains dotTrace и dotMemory, а также сценариям профилирования.

Карта выбора профилирования

Краткая карта, которая помогает понять, когда использовать инструментирование EyeAuras через MiniProfiler, а когда — full-process профилирование от JetBrains, и где искать нужный API, UI и сценарий диагностики.

Что обычно хотят сделать

Понять, почему медленно запускается приложение, загружаются модули, дерево аур или сохраняется конфиг.
Измерить script, CV, ML, input, overlay или собственный вспомогательный код.
Добавить локальные шаги измерения вокруг подозрительно медленного блока.
Сравнить поведение на прогреве и в стабильном рабочем режиме.
Снять полный CPU/performance trace, если тормозит всё приложение.
Снять memory snapshot, если процесс со временем разрастается по памяти.
Подготовить файлы, которые можно приложить к report о проблеме.

Как это устроено

В EyeAuras есть две разные группы инструментов профилирования.
MiniProfiler — это внутрипроцессное дерево таймингов из MiniProfiler for .NET. Он записывает именованные шаги: фазы старта, загрузку модулей, CV-вызовы, script loop и пользовательские блоки кода.
Данные MiniProfiler достаточно лёгкие для точечной диагностики, но они всё равно хранятся в памяти, поэтому для долгих циклов их нужно ограничивать или очищать.
Профилирование JetBrains использует JetBrains.Profiler.SelfApi, чтобы запущенное приложение могло само собирать dotTrace и dotMemory snapshot'ы.
JetBrains dotTrace нужен для CPU/performance-диагностики всего процесса: подвисания, высокий CPU, замороженный UI, медленный запуск или проблема, которую нельзя локализовать несколькими ручными таймингами.
JetBrains dotMemory нужен для анализа роста памяти, утечек, удерживаемых объектов и больших аллокаций.
Захваты JetBrains могут быть большими и во время сбора заметно влиять на отзывчивость приложения.

Когда что использовать

MiniProfiler

Используйте MiniProfiler, если путь выполнения уже известен или его можно сузить до script, service, CV-операции, участка старта, загрузки модуля, сохранения конфига или UI-действия.

Хорошо подходит для таких вопросов:

«Какая часть этого loop работает медленно?»
«Тормозит image search или проблема в OSD/input?»
«На что ушло время при старте: загрузка модулей, конфиг дерева аур или WebView?»
«Сколько заняло это сохранение конфига и почему оно вообще сработало?»
«Можно ли сравнить две реализации script по сотням итераций?»

MiniProfiler не заменяет CPU sampler. Он показывает, сколько заняли именованные инструментированные блоки. Он не объясняет автоматически все методы внутри этих блоков, если код не добавляет дополнительные steps.

JetBrains dotTrace

Используйте JetBrains dotTrace, если само приложение работает тяжело, грузит CPU, а медленный участок пока не очевиден.

Хорошо подходит, если:

EyeAuras подвисает или начинает лагать при обычной работе.
CPU высокий, но нет подозрения на один конкретный script block.
Startup или загрузка модуля медленные, а MiniProfiler показывает только широкую фазу.
Проблема появляется только через 10-30 минут обычной автоматизации.
Для support нужен performance capture, который можно открыть в dotTrace.

JetBrains dotMemory

Используйте JetBrains dotMemory, если память продолжает расти или нужно изучить большой граф удерживаемых объектов.

Хорошо подходит, если:

Working set растёт, пока продолжает работать один и тот же aura pack.
Script, overlay, CV accessor, module или window, похоже, удерживает старые объекты.
Потребление памяти уже заметно выше нормы и нужен snapshot для support.
Для воспроизведения нужно разбирать удержание объектов, а не тайминги.

API и основные сущности

StackExchange.Profiling.MiniProfiler — базовый тип MiniProfiler.
MiniProfiler.Step(string name) — создаёт дочерний шаг с таймингом; измерение заканчивается, когда освобождается возвращённый IDisposable.
MiniProfiler.Ignore() — подавляет вложенные тайминги для блока, который не нужно записывать.
MiniProfiler.RenderPlainText() — выводит данные таймингов в обычный текст.
IProfilerProvider.GetOrAdd(string name) — получает или создаёт именованный общий profiler.
IProfilerProvider.EnumerateProfilers() — возвращает общие profiler'ы для UI или отчётов.
ProfilerProvider.Default — обычный общий profiler уровня приложения.
ProfilerProvider.Startup — долгоживущий startup profiler, который используется во время инициализации приложения.
ProfilerProvider.Create(string name = default) — создаёт изолированный MiniProfiler с MemoryCacheStorage.
MiniProfilerExtensions.StepInfo(...) — обёртка над Step(...), которая при завершении пишет Info log с временем в миллисекундах.
MiniProfilerExtensions.StepDebug(...) — обёртка над Step(...), которая при завершении пишет Debug log с временем в миллисекундах.
MiniProfilerExtensions.Clear(...) — очищает кэш MemoryCacheStorage; не обещает сброс уже существующего дерева таймингов.
ICvAccessor.EnableProfiling() — включает внутренние CV-steps для одного accessor'а.
ICvAccessor.Profiler — MiniProfiler, привязанный к одному CV accessor'у.
MiniProfilerViewer / IMiniProfilerViewer — встроенный viewer дерева/текста для данных MiniProfiler.
JetBrains.Profiler.SelfApi.DotTrace — запускает, сохраняет, архивирует и завершает performance profiling sessions.
JetBrains.Profiler.SelfApi.DotMemory — создаёт memory snapshots.
IProfilerService — сервис EyeAuras, который оборачивает dotTrace/dotMemory.
ProfilerController — ориентир для поиска web-интеграции в своей поставке; наличие и доступность endpoint нужно проверять отдельно.
IProfilerViewModel — UI-состояние и команды профилирования, которые использует Settings и компактный profiler control в title bar.

Контракт профилирования в своей версии

Для следующих примеров доступны EyeAuras.Shared.Services и StackExchange.Profiling. ProfilerProvider сверён по EyeAuras 20fd3d4; WPF-команды — по PoeEye 0e02c98. В этом слое контракт называется PoeShared.Profiler.IProfilerService и содержит StartProfiling(), StopCollecting() и TakeMemorySnapshot(), возвращающие Task. Наличие JetBrains-инструментов и web endpoint зависит от поставки host.

Добавить MiniProfiler steps в код приложения

Следующий фрагмент вставляется в существующую фазу старта, где auraTreeConfigManager — уже внедрённый менеджер дерева, Log — логгер сервиса. Это место инструментирования, а не отдельный скрипт:

using (ProfilerProvider.Startup.StepInfo(Log, "Loaded aura tree config"))
{
    await auraTreeConfigManager.Load();
}

Для фаз старта и первой загрузки используйте ProfilerProvider.Startup.
Используйте StepInfo или StepDebug, если длительность шага должна ещё и попадать в логи.

Добавить MiniProfiler steps в script

using StackExchange.Profiling;
using EyeAuras.Shared.Services;

var profilerProvider = ProfilerProvider.Instance;
var profiler = profilerProvider.GetOrAdd("My pack / Farm loop");

using (profiler.Step("Loop iteration"))
{
    using (profiler.Step("Read state"))
    {
        await Task.Delay(20, cancellationToken);
    }

    using (profiler.Step("Choose action"))
    {
        await Task.Delay(10, cancellationToken);
    }
}

Log.Info(profiler.RenderPlainText());

В верхнеуровневом скрипте пример выведет дерево с двумя ожидаемыми задержками. Замените их чтением состояния и выбором действия. Повторный GetOrAdd с тем же именем вернёт общий profiler. Если нужно измерить один запуск без прежней истории, используйте ProfilerProvider.Create("One run"). Общий именованный profiler полезен для нескольких скриптов или сервисов.

Профилировать CV loop

Сначала получите CV accessor для конкретного окна или экрана и вызовите EnableProfiling(). Вложенные cv.Profiler.Step("...") измеряют ваши блоки, а внутренние CV-шаги показывают работу самого accessor. Полная подготовка входного изображения и окна приведена в профилировании CV. Не копируйте движение мыши из примера поиска, пока не проверили найденный результат и систему координат.

EnableProfiling() записывает внутренние CV-фазы: renting, preparation, refresh, model/search work и OSD.
Добавляйте свои steps вокруг не-CV-частей, чтобы в итоговом отчёте отдельно видеть detection, input, sleeps, logging и UI.

Посмотреть данные MiniProfiler в приложении

Добавьте или используйте уже существующие steps через ProfilerProvider.Startup, ProfilerProvider.Default, ICvAccessor.Profiler или именованный IProfilerProvider.
Откройте встроенную панель profiler'а, если она доступна.
Используйте Tree view, чтобы увидеть структуру parent/child таймингов.
Используйте Text view или RenderPlainText(), если результат нужно скопировать в лог или в report.
Для долгих сценариев создавайте отдельный profiler на ограниченный интервал.

Собрать JetBrains performance capture

Откройте Settings и нажмите Start profiling, либо вызовите endpoint запуска profiler'а, если управляете приложением удалённо.
Воспроизведите лаги, пока идёт сбор профиля. Для support capture обычно достаточно 10-30 минут.
Нажмите Stop profiling. В поставках с этой интеграцией ожидайте архив профиля; точное имя и каталог проверьте по сообщению host.
Приложите полученный файл через Report a problem, либо передайте его через cloud storage, если он слишком большой.

Собрать JetBrains memory snapshot

Дождитесь момента, когда потребление памяти уже явно стало ненормальным.
Используйте действие снятия memory snapshot в profiler/report workflow или вызовите endpoint takeSnapshot, если управляете приложением удалённо.
В поставках с этой интеграцией получите workspace dotMemory; каталог и имя проверьте по сообщению host.
Учитывайте, что во время записи snapshot'а приложение может подвисать или работать медленнее.
Приложите полученный файл к report о проблеме.

Практические примеры

Startup занимает 40 секунд: откройте ProfilerProvider.Startup в Tree view, затем добавьте StepInfo вокруг широкого участка, который всё ещё выглядит слишком общим.
CV aim loop кажется медленным: вызовите EnableProfiling(), оберните каждую итерацию loop и добавьте отдельные steps для ML search, OSD, движения мыши, клика и sleeps.
Сохранение конфига блокирует UI: используйте Log.CreateProfiler(...) или ProfilerProvider.Default.Step(...) вокруг serialization, записи на диск и агрегации причин изменения.
Pack работает час, а потом начинает лагать: сначала используйте MiniProfiler, если есть подозрение на loop; переключайтесь на dotTrace, если тормозит весь процесс и виновник неизвестен.
Память выросла с 500 MB до нескольких GB: снимите dotMemory snapshot, когда рост уже виден; тайминги MiniProfiler не объяснят удержание объектов.
Загрузка модуля медленная только на одной машине: используйте startup steps в MiniProfiler для локальной структуры, а если нужен CPU detail на уровне методов — снимайте dotTrace capture.

Замечания по производительности

Названия шагов MiniProfiler должны быть достаточно стабильными, если вы хотите сравнивать повторные прогоны.
Прогрев и стабильный режим лучше измерять отдельно; первые CV/ML/OCR-вызовы часто загружают модели, native libraries, capture resources или caches.
Если вы измеряете производительность, не стоит логировать внутри каждого tight loop step, если только накладные расходы logging сами не являются частью сценария.
Данные MiniProfiler живут в памяти. Для долгих циклов ограничивайте окно измерения и создавайте новый profiler. Clear() чистит кэш хранилища, но не сбрасывает явно корневое дерево уже существующего MiniProfiler.
Захваты JetBrains — это диагностика уровня support. Они полнее, чем MiniProfiler, но тяжелее и при сборе, и при анализе.
dotTrace объясняет CPU/time по всему процессу; dotMemory объясняет удержание heap и allocation'ы. Используйте profiler под тот симптом, который вы видите.

Что лучше выбирать

Лучше использовать MiniProfiler для точечных измерений конкретного code path.
Для CV API лучше сначала включать EnableProfiling(), а не писать свои таймеры вокруг каждого CV-вызова.
Для сценариев с несколькими scripts или services лучше использовать общие именованные profiler'ы.
Используйте StepInfo / StepDebug, если длительность шага должна попадать ещё и в логи.
Используйте dotTrace, если тормозит весь процесс, высокий CPU или причина замедления пока непонятна.
Используйте dotMemory для утечек, удерживаемых объектов и необъяснимого роста памяти.
При сборе JetBrains capture'ов лучше воспроизводить обычную пользовательскую нагрузку.

Чего избегать

Не используйте MiniProfiler как постоянно включённое безлимитное хранилище telemetry.
Не делайте выводы только по первой итерации прогрева.
Не объединяйте OSD, input, sleeps и detection в один безымянный блок, если сравниваете CV-алгоритмы.
Не снимайте dotMemory snapshot до того, как проблема с памятью реально проявилась.
Не собирайте длинные сессии dotTrace, если проблему можно воспроизвести коротко и прицельно.
Не отправляйте profiler archives через обычную загрузку report'а, если они слишком большие; лучше использовать cloud storage и передать ссылку.

Ключевые термины для поиска

MiniProfiler
StackExchange.Profiling
MiniProfiler.Step
MiniProfiler.Ignore
MiniProfiler.RenderPlainText
IProfilerProvider
ProfilerProvider
ProfilerProvider.Startup
ProfilerProvider.Default
MiniProfilerExtensions
StepInfo
StepDebug
Clear
MiniProfilerViewer
MiniProfilerTreeView
MiniProfilerTiming
ICvAccessor.EnableProfiling
ICvAccessor.Profiler
JetBrains.Profiler.SelfApi
DotTrace
DotMemory
IProfilerService
ProfilerController
IProfilerViewModel

Синонимы для поиска

profiler
profiling
performance profiling
memory profiling
MiniProfiler
StackExchange.Profiling
profiler step
timing tree
startup profiler
CV profiler
RenderPlainText
JetBrains profiler
dotTrace
dotMemory
SelfApi
performance snapshot
memory snapshot
traces folder
report a problem profiler files