Рекомендации по настройке отслеживания состояния компонентов Termidesk
Начальная спецификация схемы HealthCheck API в формате OpenAPI соответствует описанию:
Базовый URL для API: /api/health
.
Тип контента: application/json
.
/etc/opt/termidesk-vdi/termidesk.conf
. Порт можно переопределить в этом же файле. Для исключения злоупотреблением частыми вызовами API, способными создать нагрузку на систему, доступ к API-запросу контролируется отдельным токеном. Значение токена задается конфигурационным файлом /etc/opt/termidesk-vdi/termidesk.conf
в переменной HEALTH_CHECK_ACCESS_KEY
.
Пример:
Состояние компонента «Универсальный диспетчер»
При распределенной установке Termidesk экземпляры компонента «Универсальный диспетчер» могут быть установлены на нескольких узлах. Доступ к узлам организуется через балансировщик трафика, но для механизма проверок состояния нужно обращаться к каждому узлу напрямую.
Компонент изначально задействован для работы по протоколу HTTP, поэтому механизм проверки состояния реализуется отдельными вызовами REST API.
Пример команды проверки состояния компонента через утилиту curl
:
Состояние компонента «Шлюз»
При распределенной установке Termidesk экземпляры компонента «Шлюз» могут быть установлены на нескольких узлах. Доступ к узлам организуется через балансировщик трафика, но для механизма проверок состояния нужно обращаться к каждому узлу напрямую.
Пример команды проверки состояния компонента через утилиту curl
:
Пример ответа для работоспособного компонента:
Код 200 в ответе на API-запрос свидетельствует о работоспособности компонента «Шлюз». Отсутствие ответа говорит о том, что компонент не работает. Данное правило необходимо добавить на балансировщике трафика.
Для исключения злоупотреблением частыми вызовами API, способными создать нагрузку на систему, доступ к API-запросу компонента «Шлюз» termidesk-gateway
контролируется отдельным токеном. Значение токена задается при запуске службы «Шлюза» в параметре --healthCheckAccessKey
.
Для использования механизма проверки состояния компонента необходимо выполнить запуск Шлюза termidesk-gateway
с указанием путей расположения сертификата и ключа (--sslKey
и --sslCert
), используемых для защищенного подключения.
Пример команды запуска службы termidesk-gateway
:
Пример команды проверки состояния компонента через утилиту curl
для компонента «Шлюз» termidesk-gateway
:
Состояние компонента «Менеджер рабочих мест»
При распределенной установке Termidesk экземпляры компонента «Менеджер рабочих мест» могут быть установлены на нескольких узлах, но активен должен быть только один из них. Все остальные компоненты являются резервными и, по умолчанию, находятся в состоянии «Passive».
Для использования механизма проверки состояния компонента необходимо в конфигурационном файле /etc/opt/termidesk-vdi/termidesk.conf
раскомментировать строки параметров TASKMAN_HEALTH_CHECK_PORT
, TASKMAN_HEALTH_CHECK_CERT
,
TASKMAN_HEALTH_CHECK_KEY
. Для параметров TASKMAN_HEALTH_CHECK_CERT
, TASKMAN_HEALTH_CHECK_KEY
нужно указать путь к сертификату и ключу, используемых для защищенного подключения, и выполнить перезапуск служб Termidesk.
Пример задания значений:
Пример команды проверки состояния компонента через утилиту curl
: