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

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

Функция мониторинга предоставляет визуальную сводку состояния конфигурации и служб 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 и его вспомогательной инфраструктуры.

Помимо быстрой визуальной сводки «здоровья» сервера, страница также предоставляет следующие возможности:

• Возможность сформировать отчёт о состоянии для отправки в службу поддержки Altium (и в конечном итоге разработчикам Altium). Для этого нажмите на Generate часть текста Generate status report for support team в области Status страницы — необходимые отчёты будут сформированы и собраны в один Zip‑архив (vault_status_report_<Date>.zip) и загружены в папку загрузок браузера по умолчанию.

• Возможность скачать все файлы журналов — содержащие записи Error и Warning из всех доступных журналов сервера, которые обычно находятся в папке \ProgramData\Altium\Altium365Data\logs. Для этого нажмите ссылку Download all logs в разделе Logs страницы. Файлы будут собраны в один Zip‑архив (AllLogs.zip) и загружены в папку загрузок браузера по умолчанию.

• Используйте ссылку Clear logs (расположена внизу раздела Logs страницы), чтобы архивировать, а затем удалить все существующие файлы журналов. Архив (logs_<Date>.zip) будет сохранён в папке \ProgramData\Altium\Altium365Data\logs.archive.

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

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

  Обратите внимание: после установки Enterprise Server первая проверка работоспособности выполняется примерно через 5 минут после открытия страницы Health . Вы можете выполнить ручное обновление, чтобы запустить проверку раньше. Последующие автоматические проверки выполняются каждые 4 часа.

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

В качестве выделенной сводки статуса 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 на хост‑ПК.

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

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

• Logs – журналы Enterprise Server скачиваются в виде zip‑архива в папку загрузок браузера по умолчанию (Download all logs). Они включают текстовые логи всех служб, размещённых в Enterprise Server; файл журнала каждой службы содержит события (и ошибки) с привязкой ко времени с момента установки Enterprise Server или с момента очистки логов (Clear logs).
• Reports – отчёт о состоянии Enterprise Server скачивается в виде 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 services.

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

При установке 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, дополнительные сведения (в большинстве случаев) доступны при щелчке по записи статуса соответствующего элемента.

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

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

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

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

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

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

Log Browser

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

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

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

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

Status Report

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

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

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