下列部分描述如何从 JMX 客户端访问 WebLogic Server MBean:
为远程客户端设置类路径
如果 JMX 客户端运行在它自己的 JVM(即,不是 WebLogic Server 实例的 JVM)中,请在该客户端的类路径中包括下列 JAR 文件:
其中 WL_HOME
是 WebLogic Server 的安装目录。
此 JAR 包含 BEA 对 HTTP 和 IIOP 协议及其专用 T3 协议的实现。通过 BEA 的实现,JMX 客户端随其连接请求发送登录凭据,而 WebLogic Server 安全框架对这些客户端进行身份验证。只有通过身份验证的客户端才能访问在 WebLogic Server MBean 服务器中注册的 MBean。
注意: | 尽管 BEA 建议您使用它对 HTTP 和 IIOP 协议或其专用 T3 协议的实现,但是 JMX 客户端可以使用在标准 JDK 中定义的 IIOP 协议。请参阅仅使用 JDK 类的远程连接 。 |
建立到 MBean 服务器的远程连接
每个 WebLogic Server 域包括三种类型的 MBean 服务器,其中每一种服务器提供对不同 MBean 层次结构的访问。请参阅 MBean 服务器 。
要连接到 WebLogic MBean 服务器,请执行下列操作:
将下列参数值传递给构造方法(请参阅 “J2SE 5.0 API Specification”中的 JMXServiceURL
):
-
t3
、t3s
、http
、https
、iiop
、iiops
-
-
-
/jndi/
开头,且后跟表 4-1 中所述的 JNDI 名称之一。
-
javax.management.remote.JMXConnector
对象。此对象包含 JMX 客户端用来连接到 MBean服务器的方法。-
weblogic.management.remote
包定义可以用于连接到 WebLogic MBean 服务器的协议。远程 JMX 客户端必须在其类路径上包括此包中的类。请参阅为远程客户端设置类路径 。
-
JMXConnector
的构造方法如下:javax.management.remote.JMXConnectorFactory.
connector(JMXServiceURL serviceURL
, Map<String,?>
environment
)
将下列参数值传递给构造方法(请参阅 “J2SE 5.0 API Specification”中的 JMXConnectorFactory
):
该方法返回 javax.management.MBeanServerConnection
类型的对象。
MBeanServerConnection
对象是到 WebLogic MBean 服务器的连接。可以将它用于本地连接和远程连接。请参阅 “J2SE 5.0 API Specification”中的 MBeanServerConnection
。
示例:连接到 Domain Runtime MBean Server
请注意有关清单 4-1 中代码的下列信息:
-
connection
和connector
来表示到 MBean 服务器的连接。对于每个类实例,应该仅调用一次initConnection()
方法(它将值分配给connection
和connector
变量),以建立可以在类内重用的单个连接。 -
initConnection()
方法采用用户名和密码(以及服务器的监听地址和监听端口)作为参数,在实例化类时传递这些参数。BEA 建议使用此方法,因为它阻止代码包含未加密的用户凭据。包含这些参数的String
对象将由 JVM 的垃圾收集例程破坏并从内存中删除。 -
JMXConnector.close()
关闭到 MBean 服务器的连接。(请参阅 “J2SE 5.0 API Specification”中的JMXConnector
。)
public class MyConnection { private static MBeanServerConnection connection; private static JMXConnector connector; private static final ObjectName service; /** * 实例化与 Domain Runtime MBean Server 的连接。 */ public static void initConnection(String hostname, String portString, String username, String password) throws IOException, MalformedURLException { String protocol = "t3"; Integer portInteger = Integer.valueOf(portString); int port = portInteger.intValue(); String jndiroot = "/jndi/"; String mserver = "weblogic.management.mbeanservers.domainruntime"; JMXServiceURL serviceURL = new JMXServiceURL(protocol, hostname, port, jndiroot + mserver); Hashtable h = new Hashtable(); h.put(Context.SECURITY_PRINCIPAL, username); h.put(Context.SECURITY_CREDENTIALS, password); h.put(JMXConnectorFactory.PROTOCOL_PROVIDER_PACKAGES, "weblogic.management.remote"); connector = JMXConnectorFactory.connect(serviceURL, h); connection = connector.getMBeanServerConnection(); } public static void main(String[] args) throws Exception { String hostname = args[0]; String portString = args[1]; String username = args[2]; String password = args[3]; MyConnection c = new MyConnection(); initConnection(hostname, portString, username, password); //... connector.close(); } } }
最佳实践:选择 MBean 服务器
WebLogic Server 域维护三种类型的 MBean 服务器,其中每种类型都完成一个特定的功能。通过支持尝试完成的任务的 MBean 服务器访问 MBean:
通过 Runtime MBean Server 进行监视需要的内存和网络流量,比通过 Domain Runtime MBean Server 进行监视的小。(WebLogic Server 在客户端请求连接到它时才初始化 Domain Runtime MBean Server。)
在大多数情况下,域中的所有服务器实例具有一组相同的配置数据,因此不管在管理服务器上还是在受管服务器监视 Runtime MBean Server 都无关紧要。但是,如果所做的更改使服务器在重新启动后才能继续工作,则该服务器将不再接受任何更改,这样其配置数据可能会过时。在这种情况下,监视此服务器的 Runtime MBean Server 仅指示特定服务器实例的配置。要了解更改 WebLogic Server 域并激活更改的过程,请参阅 “了解域配置”中的管理配置更改 。
如果您向 Domain Runtime MBean Server 中的 MBean 注册 JMX 监听器和筛选器,则 JMX 筛选器与它所监视的 MBean 运行在同一个 JVM 中。例如,如果向受管服务器上的 MBean 注册筛选器,则该筛选器运行在受管服务器上,并仅将满足筛选条件的消息转发到监听器。
通常,使用 Domain Runtime MBean Server 的代码更易于维护且更安全,其原因如下:
通过 Domain Runtime MBean Server 定向所有 JMX 请求时,由于网络滞后和内存使用的增加而导致性能稍微下降。直接连接到每个受管服务器的 Runtime MBean Server 读取 MBean 值,可消除 Domain Runtime MBean Server 为了从受管服务器检索值而建立的网络跃点。但是,对于大多数网络拓扑和性能要求,Domain Runtime MBean Server 启用的简化代码维护和增强安全性更为可取。
仅使用 JDK 类的远程连接
BEA 建议您使用 WebLogic Server 类从远程 JMX 客户端进行连接。但是,远程 JMX 客户端可能仅使用 JDK 中的类连接到 WebLogic Server JMX 代理。为此,请执行下列操作:
请参阅 “管理控制台联机帮助”中的启用和配置 IIOP 。
-
javax.management.JMXConnector
对象:String hostname = "WLS-host" int port = WLS-port String protocol = "rmi"; String jndiroot= new String("/jndi/iiop://" + hostname + ":" + port + "/"); String mserver = "MBean-server-JNDI-name"; JMXServiceURL serviceURL = new JMXServiceURL(protocol, hostname, port, jndiroot + mserver); Hashtable h = new Hashtable(); h.put(Context.SECURITY_PRINCIPAL, username); h.put(Context.SECURITY_CREDENTIALS, password); connector = JMXConnectorFactory.connect(serviceURL, h);
-
WLS-host
和WLS-port
是 WebLogic Server 实例的监听地址和监听端口,MBean-server-JNDI-name
是表 4-1 中列出的值之一。
请注意,您创建的散列表不包括协议包的名称。通过将此值保留为 null,JMX 客户端使用来自 com.sun.jmx.remote.protocol
包(在 JDK 中)的协议定义。
建立 到 Runtime MBean Server 的本地连接
本地客户端可以通过 JNDI 树而不是构造 JMXServiceURL
对象,访问 WebLogic Server 实例的 Runtime MBean Server。只有 Runtime MBean Server 在 JNDI 树中注册自身。
从 JNDI 进行访问时,Runtime MBean Server 返回其 javax.management.MBeanServer
接口。此接口包含 MBeanServerConnection
接口中的所有方法以及诸如 registerMBean()
(本地进程可以使用它注册自定义 MBean)之类的其他方法。(请参阅 “J2SE 5.0 API Specification”中的 MBeanServer
。)
如果 JMX 客户端的类位于企业应用程序的顶层(即,如果它们是从应用程序的 APP-INF
目录部署的),则 Runtime MBean Server 的 JNDI 名称是:java:comp/env/jmx/runtime
如果 JMX 客户端的类位于 J2EE 模块(如 EJB 或 Web 应用程序)中,则 Runtime MBeanServer 的 JNDI 名称是:java:comp/jmx/runtime
- 例如:
InitialContext ctx = new InitialContext(); server = (MBeanServer)ctx.lookup("java:comp/jmx/runtime");
在 MBean 层次结构中导航
WebLogic Server 用一种层次数据模型来组织自己的 MBean。(请参阅 WebLogic Server MBean 数据模型 。)在此模型中,所有父 MBean 都包括包含其子级的对象名的特性。在标准 JMX API 中使用子级的对象名,可获取或设置子 MBean 的特性值或者调用其方法。
要在 WebLogic Server MBean 层次结构中导航,请执行下列操作:
请参阅上一部分:建立到 MBean 服务器的远程连接 。
启动连接将返回 javax.management.MBeanServerConnection
类型的对象。
要确定某个 MBean 在 MBean 层次结构中的位置,请参阅 WebLogic Server MBean Reference 中对该 MBean 的描述。对于每个 MBean, “WebLogic Server MBean Reference”列出了包含当前 MBean 的工厂方法的父 MBean。对于其工厂方法不是公共方法的 MBean, “WebLogic Server MBean Reference”列出了可以从其访问当前 MBean 的其他 MBean。
示例:输出服务器的名称和状态
清单 4-2 中的代码示例连接到 Domain Runtime MBean Server,并使用 DomainRuntimeServiceMBean
为域中的每个 ServerRuntimeMBean
获取对象名。然后,它检索并输出每个服务器的 ServerRuntimeMBean
Name
和 State
特性的值。
请注意有关清单 4-2 中代码的下列信息:
-
connection
和connector
全局变量外,类将 WebLogic Server 服务 MBean 的对象名分配给一个全局变量。类内的方法将频繁使用此对象名,它在定义后不需要更改。 -
printServerRuntimes()
方法获取DomainRuntimeServiceMBean
ServerRuntimes
特性的值,该特性包含域中所有ServerRuntimeMBean
实例的数组。(请参阅 “WebLogic Server MBean Reference”中的DomainRuntimeServiceMBean
。)
package cn.chenfeng; import java.io.IOException; import java.net.MalformedURLException; import java.util.Hashtable; import javax.management.MBeanServerConnection; import javax.management.MalformedObjectNameException; import javax.management.ObjectName; import javax.management.remote.JMXConnector; import javax.management.remote.JMXConnectorFactory; import javax.management.remote.JMXServiceURL; import javax.naming.Context; public class PrintServerState { private static MBeanServerConnection connection; private static JMXConnector connector; private static final ObjectName service; // 实例化 DomainRuntimeServiceMBean 对象名 // 这样可以通过类使用此对象名。 static { try { service = new ObjectName( "com.bea:Name=DomainRuntimeService,Type=weblogic.management.mbeanservers.domainruntime.DomainRuntimeServiceMBean"); } catch (MalformedObjectNameException e) { throw new AssertionError(e.getMessage()); } } /**实例化与 Domain Runtime MBean Server的连接 */ public static void initConnection(String hostname, String portString, String username, String password) throws IOException, MalformedURLException { String protocol = "t3"; Integer portInteger = Integer.valueOf(portString); int port = portInteger.intValue(); String jndiroot = "/jndi/"; String mserver = "weblogic.management.mbeanservers.domainruntime"; JMXServiceURL serviceURL = new JMXServiceURL(protocol, hostname, port, jndiroot + mserver); Hashtable h = new Hashtable(); h.put(Context.SECURITY_PRINCIPAL, username); h.put(Context.SECURITY_CREDENTIALS, password); h.put(JMXConnectorFactory.PROTOCOL_PROVIDER_PACKAGES, "weblogic.management.remote"); connector = JMXConnectorFactory.connect(serviceURL, h); connection = connector.getMBeanServerConnection(); } /** * 打印一组 ServerRuntimeMBeans。 * 此 MBean 是运行时 MBean 层次的根, * 此域中的每个服务器承载自己的实例。 */ public static ObjectName[] getServerRuntimes() throws Exception { return (ObjectName[]) connection .getAttribute(service, "ServerRuntimes"); } /** * 迭代 ServerRuntimeMBean,获取名称和状态 */ public void printNameAndState() throws Exception { ObjectName[] serverRT = getServerRuntimes(); System.out.println("got server runtimes"); int length = (int) serverRT.length; for (int i = 0; i < length; i++) { String name = (String) connection.getAttribute(serverRT[i], "Name"); String state = (String) connection.getAttribute(serverRT[i], "State"); System.out.println("Server name: " + name + ".Server state: " + state); } } public static void main(String[] args) throws Exception { String hostname = args[0]; String portString = args[1]; String username = args[2]; String password = args[3]; PrintServerState s = new PrintServerState(); initConnection(hostname, portString, username, password); s.printNameAndState(); connector.close(); } }
示例:监视 Servlet
Web 应用程序中的每个 servlet 提供 ServletRuntimeMBean
(包含有关 servlet 的运行时状态的信息)的实例。(请参阅 “WebLogic Server MBean Reference”中的 ServletRuntimeMBean
。)
在 WebLogic Server 数据模型中,ServletRuntimeMBean
的路径如下:
ComponentRuntimes
特性包含许多类型的组件运行时 MBean,其中一种是 WebAppComponentRuntimeMBean
。在获取此特性的值时,使用子 MBean 的 Type
特性可以获取特定类型的组件运行时 MBean。
清单 4-3 中的代码在上文中所述的层次结构中导航,并获取 ServletRuntimeMBean
特性的值。
package cn.chenfeng; import java.io.IOException; import java.net.MalformedURLException; import java.util.Hashtable; import javax.management.MBeanServerConnection; import javax.management.MalformedObjectNameException; import javax.management.ObjectName; import javax.management.remote.JMXConnector; import javax.management.remote.JMXConnectorFactory; import javax.management.remote.JMXServiceURL; import javax.naming.Context; public class MonitorServlets { private static MBeanServerConnection connection; private static JMXConnector connector; private static final ObjectName service; // 实例化 DomainRuntimeServiceMBean 的对象名 // 因此可以通过类使用此对象名。 static { try { service = new ObjectName( "com.bea:Name=DomainRuntimeService,Type=weblogic.management.mbeanservers.domainruntime.DomainRuntimeServiceMBean"); } catch (MalformedObjectNameException e) { throw new AssertionError(e.getMessage()); } } /** * 实例化与 Domain Runtime MBean Server 的连接 */ public static void initConnection(String hostname, String portString, String username, String password) throws IOException, MalformedURLException { String protocol = "t3"; Integer portInteger = Integer.valueOf(portString); int port = portInteger.intValue(); String jndiroot = "/jndi/"; String mserver = "weblogic.management.mbeanservers.domainruntime"; JMXServiceURL serviceURL = new JMXServiceURL(protocol, hostname, port, jndiroot + mserver); Hashtable h = new Hashtable(); h.put(Context.SECURITY_PRINCIPAL, username); h.put(Context.SECURITY_CREDENTIALS, password); h.put(JMXConnectorFactory.PROTOCOL_PROVIDER_PACKAGES, "weblogic.management.remote"); connector = JMXConnectorFactory.connect(serviceURL, h); connection = connector.getMBeanServerConnection(); } /** * 获取一组 ServerRuntimeMBean */ public static ObjectName[] getServerRuntimes() throws Exception { return (ObjectName[]) connection .getAttribute(service, "ServerRuntimes"); } /** * 获取一组 WebApplicationComponentRuntimeMBean */ public void getServletData() throws Exception { ObjectName[] serverRT = getServerRuntimes(); int length = (int) serverRT.length; for (int i = 0; i < length; i++) { ObjectName[] appRT = (ObjectName[]) connection.getAttribute( serverRT[i], "ApplicationRuntimes"); int appLength = (int) appRT.length; for (int x = 0; x < appLength; x++) { System.out.println("Application name: " + (String) connection.getAttribute(appRT[x], "Name")); ObjectName[] compRT = (ObjectName[]) connection.getAttribute( appRT[x], "ComponentRuntimes"); int compLength = (int) compRT.length; for (int y = 0; y < compLength; y++) { System.out.println(" Component name: " + (String) connection.getAttribute(compRT[y], "Name")); String componentType = (String) connection.getAttribute( compRT[y], "Type"); System.out.println(componentType.toString()); if (componentType.toString().equals( "WebAppComponentRuntime")) { ObjectName[] servletRTs = (ObjectName[]) connection .getAttribute(compRT[y], "Servlets"); int servletLength = (int) servletRTs.length; for (int z = 0; z < servletLength; z++) { System.out.println(" Servlet name: " + (String) connection.getAttribute( servletRTs[z], "Name")); System.out.println(" Servlet context path: " + (String) connection.getAttribute( servletRTs[z], "ContextPath")); System.out.println(" Invocation Total Count : " + (Object) connection.getAttribute( servletRTs[z], "InvocationTotalCount")); } } } } } } public static void main(String[] args) throws Exception { String hostname = args[0]; String portString = args[1]; String username = args[2]; String password = args[3]; MonitorServlets s = new MonitorServlets(); initConnection(hostname, portString, username, password); s.getServletData(); connector.close(); } }
相关推荐
3. **Management Clients**: 这些是使用JMX API与MBean Server交互的应用程序。在本项目中,"ops-container"可能就是一个管理客户端,它连接到WebLogic、Tomcat和WebSphere的MBean Server,并执行监控任务。 4. **...
在Windows、Linux和AIX上成功安装和配置WebLogic Application Server在一个或多个服务器与群集上部署和配置应用程序管理JMX对象,如MBean与MBeanServer 理解J2EE服务,包括EFB、JNDI、JDBC、JMS等 使用管理控制台来...
WebLogic Server内置了对JMX的支持,允许开发者通过编程方式访问WebLogic的各种管理特性,实现对服务器的动态配置、性能监控等功能。 ##### 3.1 配置MBeanServer WebLogic Server默认就已经包含了MBeanServer实例...
这里的参数设置与 Tomcat 基本一致,但需要注意的是 `javax.management.builder.initial` 参数需要指定为 `weblogic.management.jmx.mbeanserver.WLSMBeanServerBuilder`,这表示使用 WebLogic 自带的 MBean 服务器...
7. **性能调优API**:WebLogic Server提供了性能监控和调优API,如JMX MBeans,允许开发者实时获取系统资源使用情况,优化应用程序的性能。 在`javadocs`文件中,你将找到每个类、接口和方法的详细说明,包括它们的...
1. 访问My Oracle Support网站,根据你的WebLogic Server版本下载对应的补丁。 2. 查找补丁号:在My Oracle Support中搜索对应版本的补丁号,例如搜索8194412。 3. 阅读并遵循官方提供的详细安装指南。通常,这涉及...
网络逻辑JMX这是一个正在进行的工作,将经常更新,直到完成一组用于 9.X 及更高版本的 Weblogic 服务器的 JMX 服务器实用程序。 目前实时给出一些监控统计,后续会更新更多功能特征目前可以使用以下功能: JVM 监控...
JMX到Prometheus导出器:一个收集器,该收集器可以可配置地抓取和公开JMX目标的mBean。 该导出程序旨在作为Java代理运行,公开HTTP服务器并提供本地JVM的度量。 它也可以作为独立的HTTP服务器运行,并刮擦远程JMX...
4. **controls.pdf** - JMX(Java Management Extensions)和MBeans:文档介绍了WebLogic Server的管理模型,包括如何使用JMX进行服务器监控和管理,以及MBean(Managed Beans)的使用和自定义。 5. **ejb.pdf** - ...
- **Bea WebLogic**:提供了一个MBeanHome接口,并且在6.1版本中允许通过JNDI在另一个JVM中访问MBean Server。还支持远程配置功能。 - **JBoss**:JBoss使用的是`jmxri.jar`。 #### Timer MBean示例 下面是一个...
6.1 性能分析:学习使用JMX(Java Management Extensions)和JProfiler等工具监控WebLogic的性能指标,如CPU、内存、线程等。 6.2 调优实践:了解如何调整服务器配置,优化JVM参数,以及优化应用程序代码以提高性能...
例如,在WebLogic这样的应用服务器中,可以使用JMX监视和管理服务器的运行状态,如Web服务的响应时间、JDBC连接池的状态、集群健康状况等。这种监视能力对于预测和预防系统故障至关重要。 实际应用中,JMX监视架构...
WebLogic MBean Instrumentation Utility,通常被称为MBeanStat,是一个专为监控WebLogic服务器性能而设计的开源工具。MBean(Managed Bean)是Java管理扩展(JMX,Java Management Extensions)的一部分,允许...
8. **健康检查和自定义指标**:通过自定义JMX(Java Management Extensions)MBean来监测特定的业务指标。 为了有效地进行WebLogic的监测,可以使用Oracle提供的管理控制台、WLST(WebLogic Scripting Tool)以及第...
许多Java应用服务器,如WebLogic、Tomcat和JBoss,都集成了JMX,提供了丰富的管理功能。 总的来说,JMX为Java应用程序提供了一种标准化的管理方式,使得开发者能够轻松地为应用程序添加管理功能,同时为系统管理员...
例如,在 JBoss 3.0、WebLogic 等 J2EE 规范的服务器软件中,JMX 提供了统一的管理接口,使得这些服务器能够更好地管理自身以及部署在其上的应用程序。 3. **自我管理能力**:通过 JMX,可以为系统提供自我管理的...
WebLogic Server 提供了一组 MBean,可用于通过 JMX 配置、监视和管理 WebLogic Server 资源。 Ruby 版本 - 仅在 JRuby 1.7.13 上测试过 配置 - 需要为 wlfullclient.jar 设置 CLASSPATH,除非您想使用 Trinidad,...
例如,`O'Reilly - Java Management Extension.pdf`这本书可能详细介绍了JMX的各个方面,包括如何创建和注册MBeans、如何使用MBean服务器、如何实现MBean操作和属性、如何使用通知机制以及如何通过连接器进行远程...