监控WebSphere解决方案（监控应用服务器系列文章）

程序员文章站 2022-05-15 10:23:06

...

前言：做了一个监控应用服务器的项目（支持Tocmat、WebSphere、WebLogic各版本），过程也算是磕磕绊绊，由于网上缺少相关资料，或者深陷于知识的海洋难以寻觅到有效的资料，因而走过不少弯路，遇过不少困难。为了留下点印记，给后来人留下点经验之谈，助之少走弯路，故将这些经验整理出来，与大家分享。水平有限，难免疏漏，还望指正。如有疑问，欢迎留言

监控WebSphere常见的有两种方案，如下：

方案一、通过perfServletApp进行监控

perfServletApp项目是由WebSphere提供的（在安装目录下可以找到PerfServletApp.ear ，默认没有部署），用于简单的端对端检索性能数据， IBM或第三方供应商提供的任何工具都可以处理此性能数据。通过servlet访问，返回XML 格式的信息，然后解析XML即可获得相应的监控数据。

方案二、使用JMX 接口开发监控程序
通过使用PerfMBean或个别MBean，您可使用AdminClient API获取性能监控基础结构（ PMI ）数据。

两种方案优劣比较

通过 perfServletApp 进行监控	使用 JMX 接口开发监控程序
可以使用现有的成熟代码，减少工作量	全部代码需要从零开始
支持各不同版本时无差别	支持各不同版本比较麻烦，每个版本用的 JAR 包不一样，实现机制也不一样
可能存在特殊需求而 perfServlet 不能满足的情况	可支配性强，可以访问到 WAS 提供的所有 MBean

一、通过 perfServletApp 进行监控

perfServletApp 项目是由 WebSphere 提供的（在安装目录下可以找到 PerfServletApp.ear ，默认没有部署），用于简单的端对端检索性能数据， IBM 或第三方供应商提供的任何工具都可以处理此性能数据。通过 servlet 访问，返回 XML 格式的信息。

安装 perfServletApp

1. 安装 perfServletApp.ear

在管理控制台，点击左侧树中的应用程序 节点。点击企业应用程序 。

右侧的表中将列出已安装的所有应用程序。检查 perfServletApp 是否存在。如果不存在，则点击安装以安装 perfServletApp.ear 文件（默认情况下该文件位于 <WebSphere Installed Location>/WebSphere/AppServer/installableApps 目录下，例如： D:/Program Files/WebSphere/AppServer/installableApps/perfServletApp.ear ）。然后启动这个应用程序。

2. 在浏览器中打开 http://127.0.0.1:9080/wasPerfTool/servlet/perfservlet 链接，可以看到返回的 XML 文件，第一行是这样的格式：

< PerformanceMonitor responseStatus =" success " version =" 7.0.0 .5 "> ，这说明 perfServletApp 安装成功了。

配置 perfServletApp

如果是 WAS6.1 ，打开 http://127.0.0.1:9080/wasPerfTool/servlet/perfservlet 会返回 XML 格式的错误信息，第一行是这样的格式：

< PerformanceMonitor responseStatus =" failed " version =" 6.1.0 .0 "> ，

并且后面会带有“由于凭证不足或凭证为空”之类的错误提示。

这时需要进行一些配置：

1 ■ 启用应用程序安全性

监控WebSphere解决方案（监控应用服务器系列文章）

博客分类：监控应用服务器监控应用服务器监控WebSphereperfServletAppPerfMBean

2 ■ 在perfServletApp下进行安全用户的配置

监控WebSphere解决方案（监控应用服务器系列文章）

博客分类：监控应用服务器监控应用服务器监控WebSphereperfServletAppPerfMBean

3 ■ 保存修改后重启WAS即可

通过perfServletApp获取监控数据

启动WAS后打开下面的链接可以查看帮助文档：

http://127.0.0.1:9080/wasPerfTool/servlet/

获取监控数据的URL格式为：

http://perfServlet_Host:port/wasPerfTool/servlet/perfservlet[?node=<node>&server=<server>&module=<module>&version=5]

在浏览器地址栏中输入此 URL ，转向此地址后提示输入用户名密码，然后就可以看到返回了 XML格式的信息。

注意：加上 &version=5 则返回的格式是5.x ，如果不加，则返回的格式是6.0

例子：获取JVM运行时性能数据

URL 为，可以通过浏览器打开，项目中则通过Java代码访问URL：

http://127.0.0.1:9080/wasPerfTool/servlet/perfservlet?node=IE361-PCNode01&server=server1&module=jvmRuntimeModule

返回 XML 格式的 JVM 运行时性能数据：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE PerformanceMonitor (View Source for full doctype...)>
<PerformanceMonitor responseStatus="success" version="7.0.0.5">
<Node name="IE361-PCNode01">
<Server name="server1">
<Stat name="JVM 运行时">
<BoundedRangeStatisticID="1" highWaterMark="91147" integral="0.0" lastSampleTime="1294795486836" lowWaterMark="51200" lowerBound="51200" mean="0.0" name="HeapSize" startTime="1294794248020" unit="千字节" upperBound="262144" value="91147" />
<CountStatisticID="3" count="57698" lastSampleTime="1294795830112" name="UsedMemory" startTime="1294794248020" unit="千字节" />
<CountStatisticID="4" count="1582" lastSampleTime="1294795830112" name="UpTime" startTime="1294794248020" unit="SECOND" />
<CountStatisticID="5" count="0" lastSampleTime="1294795830112" name="ProcessCpuUsage" startTime="1294794248020" unit="不适用" />
</Stat>
</Server>
</Node>
</PerformanceMonitor>

在Java程序中对获得XML进行解析，即可获得相关的监控数据。

在Java程序中访问perfServletApp

通过浏览器访问perfServletApp时会提示输入用户名密码，那么在Java程序中又如何访问呢？

如果像访问一般的URL一样，直接访问，会提示鉴权错误，因为perfServletApp的URL是被保护的。

以下代码演示如何访问受保护的URL：

URL url = "http://127.0.0.1:9080/wasPerfTool/servlet/perfservlet?node=IE361-PCNode01&server=server1&module=jvmRuntimeModule");
URLConnection conn = (URLConnection) url.openConnection();

// URL授权访问 -- Begin
String password = "admin:chenfeng"; // manager角色的用户
String encodedPassword = new BASE64Encoder()
		.encode(password.getBytes());
conn.setRequestProperty("Authorization", "Basic " + encodedPassword);
// URL授权访问 -- End

InputStream is = conn.getInputStream();
BufferedReader bufreader = new BufferedReader(new InputStreamReader(is));
String line = null;
while ((line = bufreader.readLine()) != null) {
	System.out.println(line);
}

二、使用JMX接口开发监控程序

通过使用 PerfMBean 或个别 MBean ，您可使用 AdminClient API 获取性能监控基础结构（ PMI ）数据。

所需要的JAR包：

◆ com.ibm.ws.admin.client_7.0.0.jar

◆ ibmjgssprovider.jar

◆ ibmkeycert.jar

1 . WebSphere不启用管理安全性

如果WebSphere不启用管理安全性的话很简单，直接就能访问AdminClient API，看下面的代码：

Properties adminProps = new Properties();
adminProps.setProperty("type", "soap");
adminProps.setProperty("host", "127.0.0.1");
adminProps.setProperty("port", "8880");
AdminClient adminClient = AdminClientFactory.createAdminClient(adminProps);
String domainName = adminClient.getDomainName();

注意：要使上面的代码运行正确，必须关闭 WAS6.1 的管理安全性。

关闭WAS6.1的管理安全性的方法

不过出于安全性考虑，一般实际环境下的WebSphere是不可能关闭管理安全性的。

2 . WebSphere启用管理安全性

如果WebSphere已启用管理安全性，则需要先配置证书才能访问AdminClient API。在WAS6.0 里面，这个步骤很简单，默认的证书能直接用，但是 WAS6.1 就不行，默认的证书不能用，必须生成自己的证书并配置到WAS6.1里面。

WAS6.1生成和配置证书的方法

该部分本来是直接加入到本文中的，但是导致文章太长，可读性差，所以单独分了出去，地址如下，请移驾：

http://yunzhu.iteye.com/blog/1825874

使用证书监控WebSphere的示例代码

Properties adminProps = new Properties();
adminProps.setProperty(AdminClient.CONNECTOR_TYPE, AdminClient.CONNECTOR_TYPE_SOAP);
adminProps.setProperty(AdminClient.CONNECTOR_HOST, "localhost");
adminProps.setProperty(AdminClient.CONNECTOR_PORT, "8880");
adminProps.setProperty(AdminClient.USERNAME, "chenfeng");
adminProps.setProperty(AdminClient.PASSWORD, "chenfeng");
adminProps.setProperty(AdminClient.CACHE_DISABLED, "false");

// WebSphere服务器是否已启用管理安全性
adminProps.setProperty(AdminClient.CONNECTOR_SECURITY_ENABLED, "true");

adminProps.setProperty(AdminClient.CONNECTOR_AUTO_ACCEPT_SIGNER, "true");
adminProps.setProperty("javax.net.ssl.trustStore","D:/JavaTools/IBM/MyKey/trust.jks");
adminProps.setProperty("javax.net.ssl.keyStore","D:/JavaTools/IBM/MyKey/store.jks");
adminProps.setProperty("javax.net.ssl.trustStorePassword","chenfeng222");
adminProps.setProperty("javax.net.ssl.keyStorePassword", "chenfeng111");

AdminClient adminClient = AdminClientFactory.createAdminClient(adminProps);

String domainName = adminClient.getDomainName();
System.out.println("domainName" + domainName );

ObjectName objName = new ObjectName("WebSphere:name=JVM,process=server1,platform=proxy,node=YNF-PCNode01,j2eeType=JVM,J2EEServer=server1,version=6.1.0.0,type=JVM,mbeanIdentifier=JVM,cell=YNF-PCNode01Cell,spec=1.0"); 
Object freeMemory= adminClient.getAttribute(objName, "freeMemory");
System.out.println("freeMemory" + freeMemory);

上面的例子只是简单地获取DomainName和空闲内存，实际开发中采集具体的数据，则需要查询API，以获得详细的ObjectName。