Мониторинг состояния

Enterprise Server включает комплексную систему мониторинга работоспособности, которая позволяет администраторам быстро определить и проанализировать состояние, или «здоровье», Enterprise Server. Монитор работоспособности доступен в разделе Admin браузерного интерфейса Workspace (страница Server Health) либо как отдельный исполняемый инструмент, входящий в установку Enterprise Server на хост‑ПК (инструмент Server Health Monitor).

Функция Health предоставляет наглядную сводку состояния конфигурации и служб Enterprise Server, сведения о системных ресурсах хост‑машины, а также доступ к отчётам о состоянии и файлам журналов. Это даёт мгновенный обзор статуса Enterprise Server, позволяя администраторам заблаговременно выявлять и устранять проблемы, которые могут повлиять на пользователей Workspace.

Каждый из подходов к мониторингу работоспособности и статуса Enterprise Server имеет своё преимущество:

• Server Health page – как часть браузерного интерфейса Workspace Enterprise Server, страница Server Health доступна администраторам по локальной сети, что обеспечивает удобство удалённого доступа.
• Server Health Monitor tool – автономный исполняемый файл Health Monitor (avhealth.exe) доступен независимо от состояния Enterprise Server и, следовательно, предоставит критически важные данные и информацию в маловероятном случае, если Enterprise Server работает не полностью корректно.

Страница Server Health

В браузерном интерфейсе Workspace выберите Admin – Health в главном меню, чтобы открыть страницу отчёта Server Health, которая покажет общий статус установки Enterprise Server на момент времени, указанный в верхнем разделе Status страницы (Updated at: <timestamp>).

Страница Server Health обеспечивает мгновенный обзор статуса Enterprise Server и его вспомогательной инфраструктуры.

Информация на странице Server Health периодически обновляется (что отражено меткой времени Status), однако обновление можно запустить вручную с помощью соответствующей ссылки refresh status.

Нажмите ссылку обновления, чтобы актуализировать информацию о работоспособности Enterprise Server.

Ошибки и предупреждения

В качестве выделенного обзора статуса Enterprise Server страница Server Health показывает отдельные значки предупреждений/ошибок и связанные описания для проблемных записей статуса. Типичные оповещения включают просроченные резервные копии данных, приближающееся окончание лицензии, активную учётную запись admin/admin или обнаруженные записи об ошибках в файле журнала:

• OK  – обнаруженные метрики находятся в допустимом диапазоне или состоянии.
• Warning  – Enterprise Server и его вспомогательная инфраструктура функционируют корректно, но рекомендуется изменение для устранения потенциальной или будущей проблемы.
• Error  – часть Enterprise Server или его вспомогательной инфраструктуры работает или настроена некорректно и требует немедленного внимания.

Устранение типовых проблем

Хотя любые проблемы производительности и системы, вероятнее всего, решаются увеличением доступных ресурсов и улучшением инфраструктуры хост‑ПК Enterprise Server, проблемы в разделе Environment and configuration страницы Server Health обычно можно устранить с помощью функций и инструментов, доступных администраторам Workspace:

• Admin password – создайте одну или несколько отдельных учётных записей администратора на странице Users, если вы ещё этого не сделали, и измените пароль (и желательно имя пользователя) для учётной записи по умолчанию admin.
• Log level – при необходимости измените уровень логирования Enterprise Server, отредактировав запись LogLevel= в разделе General файла LocalVault.ini, расположенного в папке установки Enterprise Server на хост‑ПК. Допустимые значения уровня: Info (по умолчанию) и Warn. При выборе второго варианта общая статусная информация (вызовы API, запуск и остановка служб и т. п.) не будет включаться в файлы журналов — ошибки записываются всегда.
• Licenses – ошибка, связанная с истечением срока действия лицензии Enterprise Server, устраняется на странице Licenses браузерного интерфейса (Admin – Licenses). Уже истёкшую лицензию можно восстановить, открыв браузерный интерфейс на хост‑машине Enterprise Server.
• Backups – резервное копирование Workspace backup можно выполнить с помощью инструмента avbackup.exe, доступного в папке Tools\BackupTool внутри установки Enterprise Server на хост‑ПК.

• Project Sharing (сообщается в инструменте Health Monitor tool) – здесь может отображаться ошибка пароля для существующих участников Workspace, когда были включены и/или добавлены SVN repositories — см. пример ошибки. Это также не позволит выполнять обновления/добавления для этих профилей пользователей. Чтобы синхронизировать существующих пользователей с SVN‑репозиторием, отредактируйте профиль каждого участника, повторно введя его пароль и подтвердив кнопкой Update. Учётные данные будут обновлены в системном SVN‑файле passwd (обычно находится в папке C:\ProgramData\Altium\Altium365Data\Repository), чтобы корректно зарегистрировать этих пользователей в SVN‑репозитории.

Отчёты и журналы

Производительность как Enterprise Server, так и хост‑ПК проверяется и суммируется (в разделах Performance и System), а журналы отчётов доступны для формирования и скачивания:

• Logs – журналы Enterprise Server скачиваются в виде zip‑архива в папку загрузок браузера по умолчанию (Download all logs). Они включают текстовые логи всех служб, размещённых на Enterprise Server; файл журнала каждой службы содержит события (и ошибки) по времени с момента установки Enterprise Server либо с момента очистки логов (Clear logs).
• Reports – отчёт о состоянии Enterprise Server (Enterprise Server Status Report) скачивается в виде zip‑архива в папку загрузок браузера по умолчанию (вызывается ссылкой Generate в верхнем разделе Status страницы). В отчёте приводится статус состояния и параметры настройки всех ключевых элементов Enterprise Server. Предназначенные как ключевая информация для команд поддержки Altium, отчёты также включают сведения о состоянии и производительности вспомогательной инфраструктуры хост‑ПК.

Инструмент Health Monitor

Установка Enterprise Server включает комплексный инструмент On-Prem Enterprise Server Health Monitor, который позволяет администраторам быстро определить и проанализировать состояние, или «здоровье», Enterprise Server на локальном уровне. Поставляемый как автономное независимое приложение вместе с установкой Enterprise Server, Health Monitor предоставляет наглядную сводку состояния хост‑машины, а также конфигурации и служб Enterprise Server. Его интерфейс также содержит контекстные подсказки, а также информацию и пути к важным расположениям и файлам журналов.

Health Monitor отображает информацию о статусе Enterprise Server через простой графический интерфейс и в целом охватывает следующие критически важные области:

• Enterprise Server Environment – состояние аппаратной части хост‑ПК, например жёстких дисков, памяти, CPU и достаточность производительности.
• Enterprise Server Backend – состояние поддерживающих компонентов Enterprise Server: базы данных, файлового хранилища и репозитория.
• Enterprise Server Services – состояние набора служб Enterprise Server, размещённых как IIS Application Pools, таких как службы Identity, Authorization, License Manager и Network Installation.

Доступ к инструменту

В установке Enterprise Server по умолчанию инструмент Health Monitor находится в папке \Program Files (x86)\Altium\Altium365\Tools\HealthMonitor в виде исполняемого файла avhealth.exe. Обратите внимание, что в этой папке также есть упрощённый инструмент командной строки: avConsoleHealth.exe.

При запуске GUI‑инструмента Health Monitor (avhealth.exe) программа сразу опрашивает Enterprise Server и хост‑системы, чтобы заполнить главный экран Health Monitor Dashboard — выбранный (по умолчанию) во вкладках в верхней части. Нажмите кнопку Refresh (), чтобы повторно запустить процесс и обновить экран.

GUI Dashboard Health Monitor обеспечивает мгновенный обзор статуса Enterprise Server и его вспомогательной инфраструктуры, а также ссылки на дополнительную информацию.

Ошибки и предупреждения

Статус каждого элемента на панели Dashboard обозначается сообщением и соответствующим значком:

• OK  – обнаруженные метрики находятся в допустимом диапазоне или состоянии.
• Warning  – Enterprise Server и его вспомогательная инфраструктура функционируют корректно, но рекомендуется изменение для устранения потенциальной или будущей проблемы.
• Error  – часть Enterprise Server или его вспомогательной инфраструктуры работает некорректно и требует немедленного внимания.

Наведите курсор на статус элемента, чтобы получить больше информации. Для ошибки или предупреждения, отображаемых на Dashboard, дополнительные сведения (в большинстве случаев) доступны при щелчке по записи статуса соответствующего элемента.

Наведите курсор на запись статуса, чтобы получить более подробную информацию.

Интерактивные ссылки

Многие состояния Ошибка/Предупреждение, обнаруженные Health Monitor, содержат ссылки, предназначенные для помощи в устранении ситуации. Они включены в подробную информацию по элементу, доступную при щелчке по его записи статуса.

    
Когда возникают типовые проблемы событий, связанная информация предоставляет дополнительные детали и ссылки, помогающие устранить вызывающее беспокойство состояние.

В примере экрана слева (выше) Health Monitor обнаружил, что для Enterprise Server не выполнялось резервное копирование. Связанная информация содержит ссылку на документацию, которая поможет исправить ситуацию.

Пример экрана справа (выше) показывает, что по‑прежнему существуют учётные данные входа по умолчанию admin/admin для Enterprise Server, что создаёт существенный риск безопасности. Ссылка Fix It в связанной информации напрямую открывает страницу входа Enterprise Server через браузерный интерфейс, где можно исправить профили пользователей‑администраторов.

Log Browser

Экран Log Browser в Health Monitor, открываемый вкладкой Log Browser, показывает записи Ошибка и Предупреждение из всех доступных файлов журналов Enterprise Server — обычно расположенных в папке C:\ProgramData\Altium\Altium365Data\logs. Чтобы открыть файл журнала, содержащий запись события, выберите соответствующую ссылку Open file  или просто дважды щёлкните по самой записи.

Совокупные записи событий в списке сгруппированы по датам и включают все доступные события Ошибка/Предупреждение из всех файлов журналов. Чтобы найти конкретные события, выберите период времени в раскрывающемся меню Show logs и/или используйте динамическое поле фильтра () для поиска по ключевым словам в столбцах Subsystem и Message.

Интерфейс Log Browser позволяет точно выделять интересующие события с помощью выбираемого периода времени и фильтрации по ключевым словам.

Нажмите кнопку , чтобы удалить накопленные записи журнала из списка Log Browser — при этом все существующие файлы журналов будут архивированы, а затем удалены.

Отчет о состоянии

Экран Status Report в Health Monitor, доступный через вкладку Status Report, используется для создания и отображения файлов отчета о состоянии Enterprise Server. Сформированные отчеты собирают всю отладочную информацию о событиях в один Zip-архив (*.zip), который при необходимости можно отправить разработчикам Altium.

Чтобы создать отчет, выберите подходящий период времени событий в раскрывающемся меню Include Logs, введите свои контактные данные и выберите соглашение о предоставлении данных, затем запустите процесс кнопкой .

Используйте экран Status Report для формирования сводных файлов отчета по журналам для целей отладки.