健康监控

您正在阅读的是 7.1. 版本。关于最新版本,请前往 健康监控 阅读 8.0 版本

Enterprise Server 包含一套全面的健康监控系统,使管理员能够快速确定并分析 Enterprise Server 的状态(或“健康状况”)。健康监控可通过 Workspace 浏览器界面的 Admin 部分(Server Health 页面)访问,也可作为独立的可执行工具使用,该工具随 Enterprise Server 一同安装在其宿主 PC 上(Server Health Monitor 工具)。

健康功能提供 Enterprise Server 配置与服务状态的可视化摘要、宿主机系统资源信息,并可访问状态报告与日志文件。这能让管理员即时掌握 Enterprise Server 的整体状态,从而提前发现并解决可能影响 Workspace 用户的问题。

监控 Enterprise Server 健康与状态的两种方式各有优势:

  • Server Health page – 作为 Enterprise Server Workspace 浏览器界面的一部分,Server Health 页面可供管理员通过本地网络访问,具备远程访问的便利性。
  • Server Health Monitor tool – 独立的 Health Monitor 可执行程序(avhealth.exe)不受 Enterprise Server 当前状态影响而可用,因此在极少数 Enterprise Server 未能完全正常运行时,仍可提供关键数据与信息。

Server Health 页面

在 Workspace 的浏览器界面中,从主菜单选择 Admin – Health 以访问 Server Health 报告页面;该页面会在页面顶部 Status 区域所示的时间戳(Updated at: <timestamp>)对应时刻,指示 Enterprise Server 安装的整体状态。

Server Health 页面可即时查看 Enterprise Server 及其支撑基础设施的状态。
Server Health 页面可即时查看 Enterprise Server 及其支撑基础设施的状态。

Server Health 页面信息会定期更新(由状态时间戳指示),也可通过相关的 refresh status 链接按需触发更新。

点击刷新链接以更新 Enterprise Server 健康信息。点击刷新链接以更新 Enterprise Server 健康信息。

错误与警告

作为 Enterprise Server 状态的高亮概览,Server Health 页面会为需要关注的状态条目提供清晰的警告/错误图标及对应说明。常见告警包括:数据备份逾期、许可证即将到期、存在启用的 admin/admin 用户账户,或在日志文件中检测到错误条目:

  • OK  – 检测到的指标处于可接受范围或状态。
  • Warning  – Enterprise Server 及其支撑基础设施运行正常,但建议进行更改以消除潜在或未来问题。
  • Error  – Enterprise Server 的某个部分或其支撑基础设施未正常运行或配置不正确,需要立即处理。

修正常见问题

性能与系统问题通常可通过提升 Enterprise Server 宿主 PC 的可用资源与基础设施来解决;而 Environment and configuration 页面中 Server Health 部分的问题,一般可使用 Workspace 管理员可用的功能与工具来处理:

  • Admin password – 如果尚未创建,请在 Users 页面中创建一个或多个专用管理员账户,并修改默认 admin 账户的密码(最好也修改用户名)。
  • Log level – 如有需要,可通过编辑位于宿主 PC 上 Enterprise Server 安装目录中的 LocalVault.ini 文件里 General 部分的 LogLevel= 条目来更改 Enterprise Server 日志级别。允许的级别条目为 Info(默认)和 Warn。选择后者时,常规状态信息(API 调用、服务启动与停止等)将不会写入日志文件——但错误始终会记录。
  • Licenses – Enterprise Server 许可证即将到期的错误可通过浏览器界面的 Licenses 页面Admin – Licenses)处理。已过期的许可证可通过在 Enterprise Server 宿主机上访问其浏览器界面来解决。
  • Backups – 可使用 avbackup.exe 工具完成一次 Workspace 备份;该工具位于宿主 PC 上 Enterprise Server 安装目录内的 Tools\BackupTool 文件夹中。
  • Project Sharing(在 Health Monitor tool 中报告)– 当启用和/或添加了 SVN repositories 时,可能会在此报告现有 Workspace 成员的密码错误——参见错误示例。这也会阻止你对这些用户配置文件执行更新添加操作。要将现有用户与 SVN 仓库同步,请 编辑每个成员配置文件,重新输入其密码并点击 Update 按钮确认。凭据将更新到系统的 SVN passwd 文件(通常位于 C:\ProgramData\Altium\Altium365Data\Repository 文件夹中),以便将这些用户正确注册到 SVN 仓库。

报告与日志

Enterprise Server 与宿主 PC 的性能会被测试并汇总(在 PerformanceSystem 部分中),并提供可生成与下载的报告日志:

  • Logs – Enterprise Server Logs 会以 zip 压缩包形式下载到浏览器默认下载位置(Download all logs)。其中包含 Enterprise Server 托管的所有服务的纯文本日志;每个服务的日志文件包含自 Enterprise Server 安装以来(或日志被清除以来)的按时间记录的事件(及错误)(Clear logs)。
  • Reports – Enterprise Server Status Report 会以 zip 压缩包形式下载到浏览器默认下载位置(通过页面顶部 Status 区域中的 Generate 链接触发)。该报告会汇报所有核心 Enterprise Server 元素的状态与配置情况。报告原本用于向 Altium 支持团队提供关键信息,同时也包含宿主 PC 支撑基础设施的状态与性能信息。

Health Monitor 工具

Enterprise Server 安装包包含全面的 On-Prem Enterprise Server Health Monitor 工具,使管理员能够在本地快速确定并分析 Enterprise Server 的状态(或“健康状况”)。Health Monitor 作为随 Enterprise Server 安装提供的独立应用,可对宿主机状态以及 Enterprise Server 的配置与服务状态给出可视化摘要。其界面还包含与上下文相关的提示,以及重要位置与日志文件的相关信息与路径。

Health Monitor 通过简洁的 GUI 展示 Enterprise Server 状态信息,通常涵盖以下关键领域:

  • Enterprise Server Environment – 宿主 PC 硬件状态,例如硬盘、内存、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 按钮()可重新触发该过程并更新屏幕。

Health Monitor Dashboard GUI 可即时查看 Enterprise Server 及其支撑基础设施的状态,并提供更多信息的链接。
Health Monitor Dashboard GUI 可即时查看 Enterprise Server 及其支撑基础设施的状态,并提供更多信息的链接。

错误与警告

Dashboard 中每个项目的状态会通过消息及对应图标指示:

  • OK  – 检测到的指标处于可接受范围或状态。
  • Warning  – Enterprise Server 及其支撑基础设施运行正常,但建议进行更改以消除潜在或未来问题。
  • Error  – Enterprise Server 的某个部分或其支撑基础设施未正常运行,需要立即处理。

将鼠标悬停在某项状态上可查看更多信息。对于 Dashboard 中显示的错误或警告,大多数情况下可通过点击该项目的状态条目查看进一步细节。

将鼠标悬停在状态条目上以访问更详细的信息。
将鼠标悬停在状态条目上以访问更详细的信息。

响应式链接

Health Monitor 检测到的许多错误/警告情况都提供了用于帮助解决问题的链接。这些链接包含在该项目的详细信息中,可通过点击其状态条目查看。

当出现常见事件问题时,相关信息会提供更多细节与链接,以帮助解决所关注的状态问题。    
当出现常见事件问题时,相关信息会提供更多细节与链接,以帮助解决所关注的状态问题。

在上方左侧示例屏幕中,Health Monitor 检测到 Enterprise Server 尚未进行备份。相关信息提供了指向文档的链接,以帮助解决该问题。

上方右侧示例屏幕显示 Enterprise Server 的默认 admin/admin 登录凭据仍然存在,这会带来显著的安全风险。相关信息中的 Fix It 链接可通过浏览器界面直接打开 Enterprise Server 的登录页面,以便更正管理员用户配置文件。

注意,Dashboard 还包含指向关键位置的静态链接,例如根 Enterprise Server 与 Storage 路径(位于 ABOUT 下)以及 Log 文件夹位置(位于 FILE STORAGE 下)。

Log Browser

Health Monitor 的 Log Browser 屏幕可通过 Log Browser 标签页访问,它会呈现来自 Enterprise Server 所有可用日志文件(通常位于 C:\ProgramData\Altium\Altium365Data\logs 文件夹中)的错误与警告条目。要查看包含该事件条目的日志文件,请选择对应的 Open file 链接,或直接双击该条目本身。

列表中的累计事件条目会按日期分段,并将包含来自所有日志文件的全部可用错误/警告事件。要查找特定事件,请从 Show logs 下拉菜单中选择一个时间段,和/或使用动态过滤字段()在 SubsystemMessage 列中搜索关键字。

Log Browser 界面允许你通过可选的时间段与关键字过滤,精准定位感兴趣的事件。
Log Browser 界面允许你通过可选的时间段与关键字过滤,精准定位感兴趣的事件。

选择 按钮可从 Log Browser 列表中移除已累积的日志条目——这将先归档再删除所有现有日志文件。

状态报告

Health Monitor 的 Status Report 屏幕可通过 Status Report 选项卡访问,用于创建并显示 Enterprise Server 状态报告文件。生成的报告会将所有事件调试信息汇总到一个 Zip 归档(*.zip)中,并在需要时发送给 Altium Developers。

要创建报告,请从 Include Logs 下拉菜单中选择合适的事件时间段,输入你的联系信息并选择共享协议,然后通过 按钮启动该流程。

使用 Status Report 屏幕生成用于调试的汇总日志报告文件。
使用 Status Report 屏幕生成用于调试的汇总日志报告文件。

使用 按钮打开并查看一个已存在、之前保存的报告文件。加载的报告会填充 Log Browser 屏幕列表,并禁用 Dashboard 读数——因为加载的日志事件是历史记录(快照),而非当前事件。完成对已加载日志的查看后,选择 按钮刷新 Health Monitor,以显示 Enterprise Server 的当前状态。

AI-LocalizedAI 翻译
如您发现任何问题,请选中相关文本/图片,并按 Ctrl + Enter 键向我们提交反馈。
Content