-->
edocs Home > Oracle WebLogic Server Documentation > Administration Console Online Help >

Monitor custom MBeans

Before you begin


When you register custom MBeans in the WebLogic Server Runtime MBean Server, WebLogic Server adds entries to a runtime management information base (MIB) module that it maintains for custom MBeans. For each custom MBean type, WebLogic Server adds a table to the MIB module. For each instance of the custom MBean, it adds a table row. While WebLogic Server does not persist the module as a file or other data structure, the OIDs in the MIB module remain constant across server sessions.

WebLogic Server SNMP agents cannot periodically poll values of custom MBeans and generate notifications if a value crosses a threshold. Instead, SNMP managers must send requests to WebLogic Server SNMP agents.

To monitor custom MBeans using SNMP:

  1. To configure WebLogic Server to maintain a runtime MIB module for custom MBeans, do the following:

    1. In the Change Center of the Administration Console, click Lock & Edit (see Use the Change Center).

    2. In the Administration Console, under Domain Structure , expand Diagnostics and select SNMP .

    3. On the Summary of SNMP Agents page, click the name of an SNMP agent.

    4. On the agent's SNMP Agent: Configuration: General page, select the Access For User MBeans Enabled check box.

    5. Click the Save button.

    6. In the Change Center, click Activate Changes (see Use the Change Center).

  2. To see the objects that are in the custom MBean MIB module, use the WebLogic Scripting Tool (or a custom JMX client that you create) to invoke the outputCustomMBeansMIBModule operation in the server's SNMPAgentRuntimeMBean .

    For example, if you use the WebLogic Scripting Tool (WLST) to connect to a server named myserver, the following WLST commands invoke the outputCustomMBeansMIBModule operation:

    serverRuntime()
              cd('SNMPAgentRuntime/myserver')
              MODULE=cmo.outputCustomMBeansMIBModule()
              FILE = open("myfile.txt","w")
              FILE.writelines(MODULE)
              FILE.close() 
    

    For information on WebLogic Scripting tool, see WebLogic Scriptiong Tool. For information on the outputCustomMBeansMIBModule operation, see SNMPAgentRuntimeMBean.

    The outputCustomMBeansMIBModule operation prints the generated MIB entries to standard out.

  3. Use your SNMP managers to send GET requests that contain OIDs from the custom MBean MIB module.
} } (document.images){ dcs_imgarray[dcs_ptr] = new Image; dcs_imgarray[dcs_ptr].src = dcs_src; WT[myMeta.name.substring(3)]=myMeta.content; } if DCSext[myMeta.name.substring(7)]=myMeta.content; } } } } for (N in DCS){P+=A( N, DCS[N]);} for (N in WT){P+=A( "WT."+N, WT[N]);} for (N in DCSext){P+=A( N, DCSext[N]);} //} aCrumb=aCookie[i].split("="); if (crumb==aCrumb[0]){ return aCrumb[1]; } } return null; } i=0;i