TERA. Журналирование

Журналы TERA-сервера

Среда функционирования ВМ

Журналы работы TERA для ОС Linux расположены в директории /var/log/termidesk/tera/:

  • журнал TERA-сервера: /var/log/termidesk/tera/tera-server.log;

  • журнал ПО tera-router: /var/log/termidesk/tera-router.log.

Журналы работы TERA для ОС Microsoft Windows расположены в каталоге C:\ProgramData\UVEON\logs\TERA:

  • tera-server.log - журнал событий непосредственно TERA;

  • tera-service.log - журнал событий службы TERA Server;

  • tera-vdagent.log - журнал событий ПО TERA vdagent;

  • tera-vdservice.log - журнал событий службы TERA Agent.

К моменту запуска TERA журнал `tera-server.log`должен быть уже создан и права доступа на него должны быть правильно настроены. Если этого не сделано, то права доступа на директорию не позволят создавать файлы журналов, поскольку соответствующее приложение (Xorg) работает с правами пользователя.

Права доступа для ОС Linux

  • для директории /var/log/termidesk/tera/: rwxr-xr-x (в восьмеричной записи - 755);

  • для файлов журналов: rw-rw-rw (в восьмеричной записи - 666).

Файл журнала tera-server.log дополняется, а не пересоздаются при перезапуске Xorg. Для исключения ситуации безграничного роста файлов журналов настроена их ротация со следующими настройками по умолчанию:

  • файлы архивируются раз в сутки;

  • архивация происходит в той же директории, где расположен файл журнала;

  • максимальное количество архивных файлов - 10;

  • архивация по размеру файла не используется.

Настройки ротации расположены в файлах:

  • /etc/logrotate.d/tera-qxl;

  • /etc/logrotate.d/tera-router.

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

sudo /usr/sbin/logrotate -f /etc/logrotate.d/tera-qxl

Статус обработки ротации можно посмотреть командой:

sudo cat /var/lib/logrotate/status | grep tera
По умолчанию ротация запускается раз в сутки с помощью планировщика задач ОС Linux cron (настройки хранятся в файле /etc/cron.daily). При изменении периода архивации в файле /etc/logrotate.d/tera-qxl нужно дополнительно создать соответствующую задачу для планировщика cron.

Для ручного запуска ротации с опережением графика следует выполнить:

sudo /usr/sbin/logrotate --verbose -f /etc/logrotate.d/tera-qxl

Среда функционирования физической машины

Журналы работы TERA для ОС Linux расположены в директории /var/log/termidesk/tera/:

  • журнал ПО x11tera: /var/log/termidesk/tera/x11tera.log;

  • журнал ПО tera-router: /var/log/termidesk/tera-router.log.

К моменту запуска TERA журнал x11tera.log должен быть уже создан и права доступа на него должны быть правильно настроены. Если этого не сделано, то права доступа на директорию не позволят создавать файлы журналов, поскольку соответствующее приложения (ПО x11tera) работает с правами пользователя.

Права доступа для ОС Linux:

  • для директории /var/log/termidesk/tera/: rwxr-xr-x (в восьмеричной записи - 755);

  • для файлов журналов: rw-rw-rw (в восьмеричной записи - 666).

Файл журнала x11tera.log дополняется, а не пересоздаются при перезапуске ПО x11tera. Настройки ротации файлов журналов аналогичны среде функционирования ВМ.

Настройки ротации расположены в файлах:

  • /etc/logrotate.d/tera-x11;

  • /etc/logrotate.d/tera-router.

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

sudo /usr/sbin/logrotate -f /etc/logrotate.d/x11tera

Статус обработки ротации можно посмотреть командой:

sudo cat /var/lib/logrotate/status | grep tera
По умолчанию ротация запускается раз в сутки с помощью планировщика задач ОС Linux cron (настройки хранятся в файле /etc/cron.daily). При изменении периода архивации в файле /etc/logrotate.d/tera-x11 нужно дополнительно создать соответствующую задачу для планировщика cron.

Для ручного запуска ротации с опережением графика следует выполнить:

sudo /usr/sbin/logrotate --verbose -f /etc/logrotate.d/tera-x11

Журналы ПО tera-vdagent

Журнал работы ПО tera-vdagent можно посмотреть командой:

sudo journalctl -f | grep vdagent

Журналы ПО tera-vdagentd

Журнал работы ПО tera-vdagentd можно посмотреть командой:

sudo journalctl -fu tera-vdagentd

Журналы ПО tera-keyagent

Журнал работы ПО tera-keyagent можно посмотреть командой:

sudo journalctl -f -u tera-keyagent

Отладочный режим

Начиная с Termidesk версии 7.0 TERA поддерживает включение отладочного режима через переменную окружения TDSK_DEBUG (достаточно наличие переменной, ее значение неважно).

Переменная может быть указана:

  • в запуске каждого приложения отдельно (например через `/etc/default/<имя_службы>);

  • в запуске всех приложений сразу. Для этого используется глобальная настройка.

Для включения глобальной настройки в ОС Linux:

  • внести переменную в файл /etc/systemd/system.conf:

[Manager]
DefaultEnvironment="TDSK_DEBUG=1"

  • перезагрузить ОС.

Для отключения использования глобальной настройки в ОС Linux:

  • удалить переменную TDSK_DEBUG из файла /etc/systemd/system.conf;

  • перезагрузить ОС.

После завершения диагностики переменную TDSK_DEBUG необходимо удалить.

Для включения глобальной настройки в ОС Microsoft Windows:

  • открыть командную строку от имени администратора и выполнить:

setx TDSK_DEBUG 1 /M

  • перезагрузить ОС.

Для отключения использования глобальной настройки в ОС Microsoft Windows:

  • открыть командную строку от имени администратора и выполнить:

reg delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v TDSK_DEBUG /f

  • перезагрузить ОС.