本文档旨在介绍开源软件Hyperic HQ（以下简称HQ）的安装和配置演示过程，作为一个可以扩展的系统，HQ能监控几乎所有的主流操作系统、web 服务器、应用服务器、数据库、中间件等

1. 作者：马磊
E-mail：bmg521@gmail.com
概述
本文档旨在介绍开源软件 Hyperic HQ（以下简称 HQ）的安装和配置演示过程，
作为一个可以扩展的系统，HQ 能监控几乎所有的主流操作系统、web 服务器、应
用服务器、数据库、中间件等，另外 HQ 具有自动发现现有软件和硬件的资产列
表，能够正确显示软硬件与服务的关系的功能，其监控的指标包括内存、CPU、
硬盘、网络设备、版本以及配置信息，相应的指标可以定制相关的阀值，并对指
标属性的变化产生事件和告警。
在线文档：http://support.hyperic.com/display/DOC/HQ+Documentation
HQ 下载地址：http://www.hyperic.com/downloads
安装
安装环境
操作系统：Microsoft Windows Server 2003 Enterprise Edition SP2
硬盘：100G

2. 主频：1.66GHz
内存：1G
语言：英文
下载并安装
1）下载开源版本 Hyperic HQ 4.3.0.1，解压后在 cmd 命令行环境下执行 HQ 解压
目录中的 setup.bat 文件，开始安装 HQ Server 和 HQ Agent ，涉及到的安装选项
选择默认。
2）HQ Agent 安装完毕提示。

3. 3）HQ Server 安装中，可以看到一些安装组件和配置信息。
4）HQ Server 安装完毕，根据提示信息，通过 http://hostname:7080 访问。

4. 启动 HQ Server 和 HQ Agent
启动 HQ Server：
1) 注册服务
<Server Installation directory>binhq-server.exe -i
2) 启动
在服务控制面板中启动“Hyperic HQ Server”服务。
启动 HQ Agent：
1）注册服务

5. <Agent Installation directory>binhq-agent.bat install
2）启动
在服务控制面板中启动“Hyperic HQ Agent”服务，也可以通过命令
<Agent Installation directory>binhq-agent.bat start 启动。
管理界面概览
访问 http://hostname:7080/ ,HQ portal 首页如下:
HQ 配置管理界面由 4 部分组成：
1) Dashboard
Dashboard 界面是登入 HQ portal 后首先看到的界面，这个界面可以将所需的

6. 资源、图表或者告警加入进来，提供一个 general view 的界面，方便集中查看
和管理。
2) Resources
Resources 界面列出了所有被管理资源的列表，
可以查看各个资源的相关 KPI 和性能视图，如下图：
3) Analyze
Analyze 界面可以查看所有的事件（events）和告警（alerts），如下图：

7. 4) Administration
Administration 界面主要包括账户管理、 Server&Monitor 全局设置、
HQ 告警的
扩展处理等，如下图：

8. 主要配置
设定阀值
1) 在“ Resources->Platforms” 界面中显示的是被监控的系统列表，单击想要选
择的 Platform
2) 进 入 所 选 平 台 界 面 ， 可 以 看 到 相 关 平 台 的 KPI 视 图 ， 比 如 cpu 利 用 率 、
memory 利用率等，点击 Inventory 查看资源列表，点击 view 选择查看的视
图，点击 alert 查看告警，在 alert 界面中可以定制相关 KPI 的告警阀值。
3) 选择“Configure->NEW…”来创建一个 alert，并设置阀值

9. 这里定义了一个名为“ testalert2” 的 alert ，当 Free Memory （可以内存）大
于 0 时告警（这里只是为了测试）。
4) 设置完毕，点击 OK 查看配置信息
5) 在 Dashboard 界面中已经可以看到刚定义的告警了，见下图

10. 在“Analyzer->Alert Center”中同样可以看到告警
设置采样间隔、 KPI 可用性和 Indicator
1) 在 Administration 管理界面中选择“HQ Server Setting->Monitoring Defaults”
2) 在 Monitoring Defaults 界面中可以看到各种平台和平台服务种类，以及各种
服务类别，比如数据库、中间件、web 服务器等，见下图所示：

12. 3) 在“ Server Types” 中找到 JBoss 4.2 这一项，并点击其右侧的“ Edit Metric
Template”
4) 在 JBoss 4.2 Servers 界面中可以看到相关的 KPI 指标类表，包括利用率、吞吐
量和可用性，每个 KPI 有采样间隔时间、可用性和 Indicator 视图这三个配置
项。

13. 5) 以“ JMS Message Cache Current Memory Usage” 为例，将其采样间隔时间设
置为 10 分钟，设置为可用，Indicator 设置为 YES：
分别点击 按钮，使配置生效：

14. 6) 选 择 “ Resourses->Servers-> hostname HQ JBoss 4.x” ， 查 看 “ JMS Message
Cache Current Memory Usage” Indicators
可以看到 JMS Message Cache Current Memory Usage 的利用率为 38.4%，点击
“38.4% — Availability”查看图表(Metric Chart)

15. 告警扩展
告警扩展允许当告警生成时执行相应的动作，比如发邮件通知或发送日志信息。
以发送日志为例，首先需要配置 syslogd，即 syslog server 端，也就是 syslog 的接
受端，其次需要在 HQ server 进行相关配置。
修改<Server Installation directory>conftemplates jboss-log4j.xml，在文件
appenders 部分，去掉注释，修改如下：
<appender name="SYSLOG" class="org.apache.log4j.net.SyslogAppender">
<errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/>
<param name="Facility" value="SYSLOG"/>
<param name="FacilityPrinting" value="true"/>

16. <!—请将 localhost 改为 syslog server 端 IP -->
<param name="SyslogHost" value="localhost"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%c{1}[%r]: %m%n"/>
</layout>
</appender>
在文件 categories 部分，去掉注释，修改如下：
<category name="org.hyperic.hq.bizapp.server.action.log.SyslogAction">
<priority value="ERROR" />
<appender-ref ref="SYSLOG"/>
</category>
重新启动 HQ Server 以使配置生效。
接下来配置告警扩展信息：
1) 在 Administration 管理界面中选择“HQ Server Setting-> Escalation Schemes
Configuration”

17. 2) 创建名为“escalation-test2”的 Escalation Schema，填写并选择基本配置信息，
点击“Next step”
3) 点击“Create Action”来创建一个动作

18. 4) 选择动作 Action 的类型为“Sys Log”，填写 log 基本信息
5) 点击“Save”完成并退出，可以看到已经创建好的 Escalation

19. 附录
服务端口
服务名 端口
HQ Server Http 访问端口 7080
HQ Server secure Http 访问端口 7443
jnp service 2099
mbean server 9093
Built-in database(PostgreSQL) 9432
HQ Contact agnet 端口 2144