Подсистема ведения журнала
Подсистема ведения журнала управляет различными журналами, такими как "Приложение", "Сценарий" и "Взаимодействия".
Конфигурация
|
Настройки хранения журнала
|
Тип данных
|
По умолчанию
|
Заметки
|
||
|---|---|---|---|---|---|
|
Макс. размер файла в КБ
|
INTEGER
|
100000
|
Когда размер достигает заданного значения или превышает его, следующее событие журнала инициирует перенос файла в папку ThingworxStorage > logs > archives.
Настройку по умолчанию можно изменить во время выполнения, чтобы сразу сохранять изменения.
Максимальный размер составляет 1000000 КБ.
|
||
|
Максимальное число дней для архива
|
INTEGER
|
7
|
Ежедневные переносы управляются не часами, а зависят от возникновения событий ведения журнала. Файлы переносятся ежедневно в полночь (но только при возникновении события журнала) и перемещаются в папку archives.
Если журнал находится в архиве больше семи суток, по умолчанию он удаляется. Можно изменить значение по умолчанию на 1 или другое значение, не превышающее 90 дней.
|
||
|
Включить отслеживание стека
|
BOOLEAN
|
false
|
Если включено, то при возникновении ошибки вызова сервиса в Java API в com.thingworx.logging.LogUtilities.logInstanceExceptionDetails отслеживание связанного стека регистрируется в файле ErrorLog.log в папке ThingworxStorage > logs. Полезно для отладки ошибок при работе с платформой.
|
||
|
Включить отслеживание стека сценария
|
BOOLEAN
|
true
|
Если ошибка возникает в сценарии, связанное содержимое отслеживания стека записывается в файл ScriptErrorLog.log, расположенный в папке ThingworxStorage>logs. Полезно для отладки сценариев, созданных пользователями платформы.
|
Если в ThingWorx Platform возникает и повторяется какая-либо ошибка, журналы генерируются и печатаются в соответствующих файлах журналов, таких как журналы приложений, сценариев и базы данных. Также замечено, что ошибка повторяется в течение длительного времени, в результате чего файлы переполняются повторяющимися журналами.
Чтобы избавиться от такого сценария, введены следующие конфигурации.
Предварительные требования
Добавьте следующий фильтр в файл logback.xml.
<turboFilter class="com.thingworx.logging.RepetitiveLogFilterTest">
</turboFilter>
</turboFilter>
|
Настройки фильтра повторяющихся журналов
|
Тип данных
|
Значение по умолчанию
|
Заметки
|
|---|---|---|---|
|
Включить фильтрацию журналов
|
BOOLEAN
|
false
|
Включение или выключение фильтрации журналов.
|
|
Размер кэша
|
INTEGER
|
2000
|
Размер кэша для хранения уникальных записей в данный момент.
|
|
Разрешенные повторения
|
INTEGER
|
10
|
Число случаев ведения повторяющихся журналов (первое вхождение не учитывается в повторении).
|
|
Время истечения после записи
|
INTEGER
|
300
|
Длительность в секундах для ведения журнала разрешенных повторений.
|
|
Включить пакеты для фильтрации
|
STRING
|
Разделенный запятыми список пакетов, включаемых в фильтрацию.
|
 |
• Фильтрация журналов применима только для журналов ошибок или предупреждений для сконфигурированных пакетов в разделе Включить пакеты для фильтрации.
• Изменение значения Включить фильтрацию журналов на true и добавление имен пакетов в параметр Включить пакеты для фильтрации позволяют отслеживать повторяющиеся журналы ошибок или предупреждений.
• При изменении параметра конфигурации, упомянутого выше, записи кэша сбрасываются. Перезапускается отслеживание журналов ошибок и предупреждений, связанных со сконфигурированными пакетами.
• Повторения журналов ошибок или предупреждений отслеживаются с помощью параметра конфигурации Разрешенные повторения. Журналы ошибок или предупреждений выводятся на печать только для сконфигурированных значений.
• Печать журналов ошибок или предупреждений приостанавливается после сконфигурированного числа повторений и до истечения времени, указанного в параметре конфигурации Время истечения после записи.
• Подсчеты пропущенных и зарегистрированных повторяющихся сведений журнала регистрируются с помощью журнала уровня отладки.
• Необходимо иметь возможность конфигурировать пакеты с помощью списка, разделенного запятыми. Упомянутые пакеты будут отслеживаться для журналов ошибок или предупреждений.
• Для настройки фильтра повторяющихся журналов необходимо, чтобы в разделе Включить пакеты для фильтрации было указано полное имя пакета. Например, com.thingworx.system.subsystems.filetransfer является приемлемым именем, а com.thingworx.system.subsystems или com.thingworx.system нет.
|
Установка уровня журнала как DEBUG или TRACE будет приводить к экспоненциальному увеличению объема соответствующих журналов. Следующие конфигурации вводятся в LoggingSubsystem для сброса уровня журнала после указанного интервала:
|
Настройки автоматического сброса уровня журнала
|
Тип данных
|
Значение по умолчанию (в секундах)
|
Заметки
|
|---|---|---|---|
|
Интервал сброса глобальной трассировки в секундах
|
Целое
|
600
|
Если уровень журнала по умолчанию изменяется на TRACE для любого журнала (например, ApplicationLog и ScriptLog), указанный интервал времени действует как таймер. После выключения таймера уровень журнала возвращается к ранее заданному уровню.
|
|
Интервал сброса глобальной отладки в секундах
|
Целое
|
600
|
Если уровень журнала по умолчанию изменяется на DEBUG для любого журнала (например, ApplicationLog и ScriptLog), указанный интервал времени действует как таймер. После выключения таймера уровень журнала возвращается к ранее заданному уровню.
|
|
Интервал сброса отладки дополнительного модуля ведения журнала в секундах
|
Целое
|
3600
|
Если для какого-либо пакета дополнительного модуля задан уровень TRACE, указанный интервал времени действует как таймер. После выключения таймера уровень журнала возвращается к уровню по умолчанию для соответствующего дополнительного модуля.
Эта конфигурация помогает управлять экспоненциальным увеличением объема журнала.
|
|
Интервал сброса трассировки дополнительного модуля ведения журнала в секундах
|
Целое
|
3600
|
Если для какого-либо пакета дополнительного модуля задан уровень DEBUG, указанный интервал времени действует как таймер. После выключения таймера уровень журнала возвращается к уровню журнала по умолчанию для соответствующего дополнительного модуля.
Эта конфигурация помогает управлять экспоненциальным увеличением объема журнала.
|
|
|
• Если перезапустить сервер ThingWorx Platform или все узлы, то указанный интервал сброса для глобального и дополнительного модуля запускается снова.
• Для функциональности сброса уровень журнала ALL действует так же, как и уровень журнала TRACE. У него нет отдельного таймера, и используются интервалы уровней TRACE глобального и дополнительного модулей.
|