Диагностика и контроль состояния
Раздел «Диагностика» показывает текущее состояние хранилища и помогает быстро обнаружить проблемы конфигурации. Его рекомендуется открывать после установки, обновления, изменения настроек хранения и при любых вопросах по созданию версий или файлов.
[Скриншот 1: верхняя часть диагностики с общей статистикой]
Общая статистика
- Всего версий — общее число записей истории.
- Файлов в хранилище — количество сохранённых файлов версий.
- Устаревших файлов — количество файлов в архиве obsolete.
- Записей в таблице файлов — количество связей файлов с версиями.
Если число записей в таблице файлов заметно отличается от реального количества файлов, это не всегда ошибка: часть записей может ссылаться на общий файл или на путь без физической копии. Для расследования используйте просмотр конкретной версии.
Проблемы конфигурации
Диагностика выполняет несколько проверок и выводит предупреждения/ошибки. В версии 0.9.802 проверяются:
- существование папки файлового хранилища;
- возможность записи в папку хранилища;
- включён ли хотя бы один тип сущности;
- доступность основных таблиц версий и файлов.
Если папка ещё не создана, но модуль не сохранял файлов, предупреждение может быть нормальным: каталог создаётся при первом сохранении файла.
Статистика по типам
Отдельные карточки показывают количество версий по типам сущностей, действиям и типам снимков. Это помогает понять структуру истории и заметить аномалии — например, неожиданно большой объём ручных версий.
Топ инфоблоков по версиям
Таблица показывает, какие инфоблоки создают больше всего истории. Если база быстро растёт, этот блок помогает определить источник и решить, нужен ли для него такой объём версионирования.
[Скриншот 2: таблицы по типам сущностей, действиям и топу инфоблоков]
Базисные версии по инфоблокам
Здесь отдельно подсчитываются базисные версии элементов, разделов и торговых предложений, общий итог и дата последнего базиса. После первичной настройки используйте таблицу для проверки, что нужные инфоблоки действительно получили исходные снимки.
Текущие настройки
В нижней части показана краткая сводка: включены ли элементы, разделы и торговые предложения, работает ли режим значимых изменений, какой режим файлов выбран, включена ли архивация obsolete и запись в EventLog, какие инфоблоки исключены и какие лимиты хранения заданы.
[Скриншот 3: диагностика: базисные версии и текущие настройки]
Как использовать диагностику при проблеме
Версии не создаются
- Проверьте, включён ли нужный тип сущности.
- Проверьте список исключённых инфоблоков.
- Убедитесь, что таблицы доступны.
- Проверьте правило создания версии для добавления/изменения/удаления.
- Если включены только значимые изменения, внесите реальное изменение текста или свойства и повторите тест.
Не восстанавливаются файлы
- Проверьте количество файлов в хранилище.
- Откройте конкретную версию и посмотрите таблицу файлов.
- Проверьте права записи на upload.
- Проверьте архив устаревших файлов, если проблема возникла после отката.
Хранилище быстро растёт
- Посмотрите топ инфоблоков по версиям.
- Проверьте значение «Только значимые изменения».
- Проверьте keep_days и keep_last.
- Проверьте размер и срок хранения устаревших файлов.
- Исключите технические инфоблоки, если их история не нужна.
После изменения настроек
Диагностика показывает сохранённые параметры, но не запускает очистку немедленно. Политики keep_days/keep_last применяет ежедневный агент, а устаревшие файлы можно дополнительно очистить вручную на соответствующей странице.
Как читать статистику после создания базиса
Сразу после первичного базиса количество MANUAL-снимков может резко вырасти — это ожидаемо. После перехода в обычную работу основную долю новых записей обычно составляют UPDATE, а DELETE и RESTORE появляются эпизодически.
Диагностика не исправляет данные автоматически
Страница показывает состояние и предупреждения, но не переустанавливает таблицы, не меняет права каталога и не запускает миграции. Если показана ошибка таблицы или файловой системы, исправление выполняется администратором сайта.
Проверка после массовой операции
После импорта каталога, массового редактирования или создания базиса сравните количество новых версий с ожидаемым числом объектов. Слишком большое расхождение помогает заметить неправильно выбранную область ещё до того, как история сильно разрастётся.
Проверка исключённых инфоблоков
В сводке выводятся ID исключённых инфоблоков. Если нужный инфоблок неожиданно не создаёт версии, этот список — одно из первых мест для проверки.