По умолчанию при установке Платформы каталог для хранения логов и событий Logs создается в общей папке для хранения данных, то есть располагается по пути C:\ProgramData\Datareon\Platform\Logs для Windows и /var/datareon/platform/logs для Linux.
При необходимости указать другой каталог:
Windows: укажите путь к каталогу на этапе установкиРазмещение файлов в параметре Размещать данные логирования отдельно и установите соответствующий флаг
Linux: следуя инструкции, установите путь к каталогу в файле /etc/environment либо командой platformmanager initenvironment -n LOGS_FOLDER -v
В папке Logs в соответствующих каталогах хранятся логи и события сервера, сервисов и систем.
Внутри этих каталогов расположены папки с указанием EntityId объектов Платформы, чьи логи в них размещены. Глубже расположены папки Debug и Events:
в папку Debug логируются записи из вкладки Журнал соответствующего объекта в Центре Мониторинга.
в папку Events логируются записи из вкладки События соответствующего объекта в Центре Мониторинга.
В папках Debug и Events расположены файлы с логами и событиями, а также каталог Temp, в котором размещаются временные файлы.
Для контроля занимаемого места на диске реализован блок настроек logStorageParams.
Для серверов, сервисов или систем настройки берутся из их конфигурации. Если в их конфигурации блок настроек logStorageParams не задан, то значения настроек берутся из конфигурации кластера.
Значения параметров в logStorageParams влияют на то, в какой момент и в каком объеме будет выполняться архивация или удаление файлов логов и событий.
storeDays (int): длительность хранения в днях. Значение по умолчанию 0.
uncompressedDays (int): архивация файлов, которые лежат больше uncompressedDays суток. Значение по умолчанию 0.
uncompressedMaxSizeMb (int): архивация старых файлов, если объем файлов в папке Debug или Events превышает uncompressedMaxSizeMb МБ. Значение по умолчанию 50, допускаются значения >0.
folderMaxSizeMb (int): максимальное количество в Мб файлов в папке Debug или Events, включая архивные. Значение по умолчанию 50, допускаются значения >0.
tempFolderMinSizeMb (int): минимальное количество в Мб файлов в папке Temp. Значение по умолчанию 10.
tempFolderMaxSizeMb (int): максимальное количество в Мб файлов в папке Temp. Значение по умолчанию 30.
Внимание
При распаковке большого объема архивных событий может возникнуть ошибка формата «Сработал лимит на размер директории Temp». В этом случае увеличьте значение tempFolderMaxSizeMb, сохраните изменения и примените конфигурацию.
tempStoreMinutes (int): периодичность очистки папки Temp. Значение по умолчанию 4.
Для более компактного хранения файлов логов и событий выполняется автоматическая архивация файлов.
В процессе архивации участвуют параметры uncompressedDays и uncompressedMaxSizeMb:
если uncompressedDays>0, то архивируются все файлы в папках Debug и Events, которые лежат больше указанного числа суток. При значении по умолчанию или при uncompressedDays=0 процесс архивации не выполняется.
если uncompressedMaxSizeMb>0, то в каждой из папок Debug и Events считается объем несжатых файлов и архивируются самые старые файлы, пока превышение объема не будет устранено.
Имя архивируемого файла имеет вид: arch_16052022_14_13_debug-20220410-00001.zip, где:
первая дата - дата и время архивации.
вторая - дата исходного файла.
Внутри файла ZIP исходный файл с датой создания в имени файла вида debug-20220410-00001.log или events-20220410-00001.log.
Во избежание превышения максимально допустимого объема хранимых логов и событий выполняется автоматическое удаление их файлов, начиная с самых старых.
В процессе удаления участвуют параметры folderMaxSizeMb и storeDays. Кратко принцип работы:
если storeDays>0, то в папках Debug или Events удаляются все файлы (включая архивные), которые лежат больше storeDays дней. При значении по умолчанию или при storeDays=0 данный процесс не выполняется.
если folderMaxSizeMb>0, то в каждой из папок Debug или Events считается объем всех файлов (включая архивные) и удаляются самые старые из них, пока превышение объема не будет устранено.
Проверка необходимости очистки запускается при применении конфигурации и при создании нового файла с логами или событиями.
Проверка при превышении объема хранения folderMaxSizeMb
При проверке высчитывается значение по формуле: РазмерКорня - Temp.ТекущийРазмер + МАКС(Temp.ТекущийРазмер,tempFolderMinSizeMb)
РазмерКорня: это размер всех log и zip файлов, находящихся в каталоге Debug или Events.
Temp.ТекущийРазмер: это размер всех файлов, находящихся в каталоге Temp.
МАКС(Temp.ТекущийРазмер, tempFolderMinSizeMb): выбирает большее значение из двух:
если папка Temp занята сильнее, чем минимальный порог, учитывается фактический размер.
если папка Temp почти пустая, то в расчет берется минимальный размер (по умолчанию 10 МБ).
Это необходимо, чтобы при расчёте допустимого общего объёма каталога всегда оставался резерв под временные файлы в папке Temp.
Если получившееся по формуле значение превышает лимит folderMaxSizeMb, то запускается удаление самых старых файлов, пока размер не станет меньше лимита.
Проверка при превышении срока хранения storeDays
При проверке отсчитывается ровно то количество дней в часах (1 день = 24 часа), которое задано в параметре storeDays, считая от текущего времени. Удаляются все файлы, срок хранения которых больше указанного.
При неуспешной установке Платформы необходимо посмотреть ошибки в системных журналах.
Ошибки установки регистрируются в системном журнале на Windows в приложении Просмотр событий во вкладке Журналы приложений и служб → 3.0_DatareonPlatform
Ошибки установки регистрируются для Linux в системном логе
