Журналы

Логирование на диск

В настройках Кластера, Систем, Сервера и Сервисов находится блок logStorageParams, определяющий условия хранения и удаления файлов с логами. Настройки блока параметров LogStorageParams во внешней системе имеют приоритет над настройками кластера.

Каталог для хранения файлов с логами настраивается при установке Платформы из дистрибутива на этапе Размещение. Чтобы выбрать другой путь для размещения логов, нужно установить флажок Размещать данные логирования отдельно и указать путь до папки.

../_images/image37.png

Если выбрать вариант установки без отдельного размещения, тогда папка Logs для хранения логов будет создана в общей папке для хранения данных. (По умолчанию C:\ProgramData\Datareon\Platform\Logs).

В этой папке хранятся логи для всех сервисов и систем, настроенных в Платформе.

../_images/image381.png

У каждого объекта есть папки Debug и Events.

В папку Debug логируются записи из вкладки Журнал соответствующего объекта в Центре Мониторинга. В папку Events логируются записи из вкладки События соответствующего объекта в Центре Мониторинга.

В папках Temp лежат временные файлы.

Детализация логируемых данных определяется согласно настроенному уровню логирования и дополнительным разделам журнала в параметрах кластера.

Эти параметры могут быть переопределены на вкладке Логирование любого объекта Платформы в Центре Мониторинга.

Папка Logs очищается согласно настройкам в блоке logStorageParams.

"logStorageParams": {
"$type": "DT.LogStorageParams, DT_Core",
 "storeDays": 0,
 "folderMaxSizeMb": 50,
 "uncompressedDays": 0,
 "uncompressedMaxSizeMb": 30,
 "tempFolderMinSizeMb": 10,
 "tempFolderMaxSizeMb": 100,
 "tempStoreMinutes": 4
},

Параметры блока logStorageParams:

  • int StoreDays: по умолчанию 0 (Длительность хранения в днях);

  • int uncompressedDays: по умолчанию 0 (Архивация файлов, которые лежат больше uncompressedDays суток);

  • int uncompressedMaxSizeMb: по умолчанию 50 (Архивация старых файлов, если объем файлов превышает uncompressedMaxSizeMb МБ в папке);

  • int FolderMaxSizeMb: по умолчанию 50 (Максимальное количество в Мб файлов в папке, включая архивные);

  • int tempFolderMinSizeMb: по умолчанию 10 (Минимальное количество в Мб файлов в папке Temp);

    Внимание

    При возникновении ошибки Сработал лимит на размер директории Temp увеличьте значение tempFolderMaxSizeMb, сохраните изменения и примените конфигурацию.

  • int tempFolderMaxSizeMb: по умолчанию 30 (Максимальное количество в Мб файлов в папке Temp);

  • int tempStoreMinutes: по умолчанию 4 (периодичность очистки папки Temp);

  • Если StoreDays>0, то папки (debug и events) чистятся, удаляются все файлы, включая архивные, которые лежат больше StoreDays дней. При значении по умолчанию или при StoreDays=0 данный процесс удаления не выполняется;

  • Если uncompressedDays>0, то архивируются все файлы в папках debug и events, которые лежат больше указанного числа суток. При значении по умолчанию или при uncompressedDays=0 данный процесс архивации не выполняется.

Имя архивируемого файл имеет вид: arch_16052022_14_13_debug-20220410-00001.zip, где:

  • первая дата - дата архивации и затем время архивации;

  • вторая - дата исходного файла.

Внутри файла ZIP исходный файл с датой создания в имени файла: debug-20220410-00001.log;

  • Если uncompressedMaxSizeMb>0, то в каждой из папок debug и events считаем объем несжатых файлов и архивируем лишние самые старые файлы. Не допускается задание значения uncompressedMaxSizeMb=0, при нулевом значении выводится предупреждение;

  • Если folderMaxSizeMb>0, то в каждой из папок debug и events считаем объем всех файлов, включая архивные, и удаляем лишние самые старые файлы, включая архивы. Не допускается задание значения folderMaxSizeMb=0, при нулевом значении выводится предупреждение.

Очистка происходит:

  • При применении конфигурации.

  • При создании нового файла с логами/трейсами.

  • Принятие решения об очистке, высчитывается значение по формуле:

Формула = РазмерКорня - Temp.ТекущийРазмер + МАКС(Temp.ТекущийРазмер,tempFolderMinSizeMb).

  • РазмерКорня: это размер всех log и zip файлов, находящихся в каталоге с логами модуля/системы.

  • Temp.ТекущийРазмер: это суммарный размер всех файлов, которые находятся в папке Temp. Размер вычисляется в байтах.

  • МАКС(Temp.ТекущийРазмер, tempFolderMinSizeMb): выбирает большее значение из двух:

    • если папка Temp занята сильнее, чем минимальный порог, учитывается фактический размер;

    • если папака Temp сейчас почти пустая, всё равно закладывается минимальный размер в расчёт.

    При расчёте общего объёма учитывается либо фактический размер временной папки (Temp), либо минимальный гарантированный размер, заданный параметром tempFolderMinSizeMb (по умолчанию 10 МБ).

    Это необходимо, чтобы при расчёте допустимого общего объёма каталога всегда оставался резерв под временные файлы (Temp).

Если получившееся в формуле значение превышает лимит (folderMaxSizeMb), то запускается удаление самых старых файлов, пока размер не станет меньше лимита.

При хранении по дням отсчитывается ровно то количество дней в часах (1 день = 24 часа), которое задано в блоке logStorageParams в параметре StoreDays, считая от текущего времени.

Для всех сервисов настройки берутся из их конфигурации. Если в конфигурации сервиса настройки не заданы, тогда они берутся из конфигурации кластера.

Регистрация ошибок в системных журналах

При неуспешной установке Платформы необходимо посмотреть ошибки в системных журналах.

Ошибки установки регистрируются в системном журнале на Windows в приложении Просмотр событий во вкладке Журналы приложений и служб → 3.0_DatareonPlatform

../_images/image42.png

Ошибки установки регистрируются для Linux в системном логе

../_images/image43.png