Рецепт · OpenClaw

slow session patch: где задержался патч сессии

По временам фаз в slow session patch определите, какую часть sessions.patch заняло больше секунды.

· 2 мин чтения

Коротко

  • slow session patch — это запись уровня info в файловом логе для вызовов sessions.patch и sessions.patchMany, которые длились не меньше секунды.
  • С 2026.10.5 запись появляется даже при выключенном diagnostics.
  • В сообщении есть общее время, метод и фиксированные фазы. Их суммы не образуют точное разбиение времени запроса.

Сверено с документацией OpenClaw 2026.10.5, 22 октября 2026.

Когда sessions.patch занимает больше секунды, в логе появляется строка slow session patch с общим временем и длительностями фаз.

Где искать запись

Файл лога задаётся через logging.file. По умолчанию используется путь /tmp/openclaw/openclaw-YYYY-MM-DD.log. Ищите строки slow session patch на уровне info.

Как читать строку slow session patch

Документация приводит пример: slow session patch 1176ms method=sessions.patch catalog=1100ms response=20ms. Здесь 1176ms означает общее время, method задаёт RPC, а catalog и response показывают длительности фаз.

slow session patch 1176ms method=sessions.patch catalog=1100ms response=20ms

Фиксированный набор фаз включает допуск жизненного цикла (lifecycle admission), чтение снимков (snapshot reads), подготовку каталога (catalog preparation), проекцию (projection), фиксацию (commit), подтверждения среды выполнения (runtime acknowledgements), эффекты (effects) и формирование ответа (response work). Повторные посещения фазы добавляются к её сумме.

Запись не содержит значений патча и ключей сессий. Если доступна диагностическая трассировка запроса, запись наследует её.

Почему сумма фаз больше времени запроса

Параллельные и вложенные фазы могут пересекаться. Поэтому их суммы не являются точным разбиением времени запроса и не измеряют использование CPU.

Не складывайте длительности фаз вручную. Сравнивайте их с общим временем вызова, учитывая возможные пересечения.

Что появилось в 2026.10.5

  • Запись slow session patch пишется даже при выключенном diagnostics.enabled.
  • Длительности фаз теперь видны прямо в тексте сообщения — для транспортов, которые не передают структурные поля.
  • При подготовке снимков на замену используется metadata reader для точных выборок по ключу и maintenance reader для больших выборок по владельцу метки, независимо от читателя истории транскрипта.
  • Фаза projection готовит метаданные выбора создателя, не дожидаясь несвязанных строк отображения сессии.
  • Фаза evidence читает членство и текущие метаданные управления за один снимок.

Где ломается и когда не применять

  • Если вызов длится меньше секунды, запись slow session patch не появляется.