Before you begin
WebSphere Application Server allows you to invoke methods on MBeans through the AdminClient Java Management Extension (JMX) interface. You can use AdminClient API to get Performance Monitoring Infrastructure (PMI) data by using either PerfMBean or individual MBeans. See information about using individual MBeans at bottom of this article.Individual MBeans provide the Stats attribute from which you can get PMI data. The PerfMBean provides extended methods for PMI administration and more efficient ways to access PMI data. To set the PMI module instrumentation level, you must invoke methods on PerfMBean. To query PMI data from multiple MBeans, it is faster to invoke the getStatsArray method in PerfMBean than to get the Stats attribute from multiple individual MBeans. PMI can be delivered in a single JMX cell through PerfMBean, but multiple JMX calls have to be made through individual MBeans.
See the topic "Developing an administrative client program" for more information on AdminClient JMX.
Why and when to perform this task
After the performance monitoring service is enabled and the application server is started or restarted, a PerfMBean is located in each application server giving access to PMI data. To use PerfMBean:Steps for this task
The example code is:
AdminClient ac = null; java.util.Properties props = new java.util.Properties(); props.put(AdminClient.CONNECTOR_TYPE, connector); props.put(AdminClient.CONNECTOR_HOST, host); props.put(AdminClient.CONNECTOR_PORT, port); try { ac = AdminClientFactory.createAdminClient(props); } catch(Exception ex) { failed = true; new AdminException(ex).printStackTrace(); System.out.println("getAdminClient: exception"); }
javax.management.ObjectName on = new javax.management.ObjectName("WebSphere:*"); Set objectNameSet= ac.queryNames(on, null); // you can check properties like type, name, and process to find a specified ObjectName
HashSet nodeSet = new HashSet(); for(Iterator i = objectNameSet.iterator(); i.hasNext(); on = (ObjectName)i.next()) { String type = on.getKeyProperty("type"); if(type != null && type.equals("Server")) { nodeSet.add(servers[i].getKeyProperty("node")); } }Note, this will only return nodes that are started.
StringBuffer oNameQuery= new StringBuffer(41); oNameQuery.append("WebSphere:*"); oNameQuery.append(",type=").append("Server"); oNameQuery.append(",node=").append(mynode); oSet= ac.queryNames(new ObjectName(oNameQuery.toString()), null); Iterator i = objectNameSet.iterator (); while (i.hasNext ()) { on=(objectName) i.next(); String process= on[i].getKeyProperty("process"); serversArrayList.add(process); }
for(Iterator i = objectNameSet.iterator(); i.hasNext(); on = (ObjectName)i.next()) { // First make sure the node name and server name is what you want // Second, check if the type is Perf String type = on.getKeyProperty("type"); String node = on.getKeyProperty("node"); String process= on.getKeyProperty("process"); if (type.equals("Perf") && node.equals(mynode) & & server.equals(myserver)) { perfOName = on; } }
- setInstrumentationLevel: set the instrmentation level params[0] = new MBeanLevelSpec(objectName, optionalSD, level); params[1] = new Boolean(true); signature= new String[]{ "com.ibm.websphere.pmi.stat.MBeanLevelSpec", "java.lang.Boolean"}; ac.invoke(perfOName, "setInstrumentationLevel", params, signature); - getInstrumentationLevel: get the instrumentation level Object[] params = new Object[2]; params[0] = new MBeanStatDescriptor(objectName, optionalSD); params[1] = new Boolean(recursive); String[] signature= new String[]{ "com.ibm.websphere.pmi.stat.MBeanStatDescriptor", "java.lang.Boolean"}; MBeanLevelSpec[] mlss = (MBeanLevelSpec[])ac.invoke(perfOName, "getInstrumentationLevel", params, signature); - getConfigs: get PMI static config info for all the MBeans configs = (PmiModuleConfig[])ac.invoke(perfOName, "getConfigs", null, null); - getConfig: get PMI static config info for a specific MBean ObjectName[] params = {objectName}; String[] signature= { "javax.management.ObjectName" }; config = (PmiModuleConfig)ac.invoke(perfOName, "getConfig", params, signature); - getStatsObject: you can use either ObjectName or MBeanStatDescriptor Object[] params = new Object[2]; params[0] = objectName; // either ObjectName or or MBeanStatDescriptor params[1] = new Boolean(recursive); String[] signature = new String[] { "javax.management.ObjectName", "java.lang.Boolean"}; Stats stats = (Stats)ac.invoke(perfOName, "getStatsObject", params, signature); Note: The returned data only have dynamic information (value and time stamp). See PmiJmxTest.java for additional code to link the configuration information with the returned data. - getStatsArray: you can use either ObjectName or MBeanStatDescriptor ObjectName[] onames = new ObjectName[]{objectName1, objectName2}; Object[] params = new Object[]{onames, new Boolean(true)}; String[] signature = new String[]{"[Ljavax.management.ObjectName;", "java.lang.Boolean"}; Stats[] statsArray = (Stats[])ac.invoke(perfOName, "getStatsArray", params, signature); Note: The returned data only have dynamic information (value and time stamp). See PmiJmxTest.java for additional code to link the configuration information with the returned data. - listStatMembers: navigate the PMI module trees Object[] params = new Object[]{mName}; String[] signature= new String[]{"javax.management.ObjectName"}; MBeanStatDescriptor[] msds = (MBeanStatDescriptor[])ac.invoke(perfOName, "listStatMembers", params, signature); or, Object[] params = new Object[]{mbeanSD}; String[] signature= new String[] {"com.ibm.websphere.pmi.stat.MBeanStatDescriptor"}; MBeanStatDescriptor[] msds = (MBeanStatDescriptor[])ac.invoke (perfOName, "listStatMembers", params, signature);