Oracle® Fusion Middleware

Monitoring and Managing With the Java EE Management APIs for Oracle WebLogic Server

12c Release 1 (12.1.1)

E24447-01

December 2011

This document describes the Java EE Management APIs which enable a software developer to create a single Java program that can discover and browse resources, such as JDBC connection pools and deployed applications, on any Java EE Web application server.

Introduction and Roadmap

The Java EE Management specification describes a standard data model for monitoring and managing the run-time state of any Java EE Web application server and its resources. It includes standard mappings of the model through a Java EE Management EJB Component (MEJB).

The following sections describe the contents and organization of this guide—Monitoring and Managing With the Java EE Management APIs for Oracle WebLogic Server:

- Document Scope and Audience

- Guide to This Document

- Related Documentation

Document Scope and Audience

This document is a resource for software developers who develop management services for Java EE applications and for software vendors who develop JMX-compatible management systems. It also contains information that is useful for business analysts and system architects who are evaluating WebLogic Server or considering the use of JMX for a particular application.

The information in this document is relevant during the design and development phases of a software project. The document does not address production phase administration, monitoring, or performance tuning topics. For links to WebLogic Server documentation and resources for these topics, see Related Documentation.

It is assumed that the reader is familiar with Java EE and general application management concepts. This document emphasizes a hands-on approach to developing a limited but useful set of JMX management services. For information on applying JMX to a broader set of management problems, refer to the JMX specification or other documents listed in Related Documentation.

Guide to This Document

This document is organized as follows:

- This section, Introduction and Roadmap, describes the scope and organization of this guide.

- Using the Java EE Management APIs on WebLogic Server, introduces JMX and describes common ways to use it in conjunction with other WebLogic Server management features.

- WebLogic Server Extensions, describes WebLogic-specific extensions to JSR 77.

Related Documentation

Oracle has a Web site that provides links to books, white papers, and additional information on JMX: http://www.oracle.com/technetwork/java/javase/tech/javamanagement-140525.html.

To view the JMX 1.2 specification and API documentation, download it from http://jcp.org/aboutJava/communityprocess/final/jsr003/index3.html.

To view the JMX Remote API 1.0 specification and API documentation, download it from http://jcp.org/aboutJava/communityprocess/final/jsr160/index.html.

For guidelines on developing other types of management services for WebLogic Server applications, see the following documents:

- Using WebLogic Logging Services for Application Logging describes WebLogic support for internationalization and localization of log messages, and shows you how to use the templates and tools provided with WebLogic Server to create or edit message catalogs that are locale-specific.

- Configuring and Using the WebLogic Diagnostic Framework describes how system administrators can collect application monitoring data that has not been exposed through JMX, logging, or other management facilities.

For guidelines on developing and tuning WebLogic Server applications, see the following documents:

- Developing Applications with WebLogic Server is a guide to developing WebLogic Server applications.

- Developing Manageable Applications with JMX describes how to create and register custom MBeans.

Using the Java EE Management APIs on WebLogic Server

The Java EE Management APIs enable a software developer to create a single Java program that can discover and browse resources, such as JDBC connection pools and deployed applications, on any Java EE Web application server. The APIs are part of the Java EE Management Specification, which requires all Java EE Web application servers to describe their resources in a standard data model.

The following sections describe how to use the Java EE Management APIs on WebLogic Server:

- Understanding the Java EE Management Model and APIs

- The Java EE Management Model on WebLogic Server

- Accessing the MEJB on WebLogic Server

Understanding the Java EE Management Model and APIs

In the Java EE Management data model, each instance of a Web application server resource type is represented by a Java EE Managed Object (JMO). The Java EE Management Specification describes exactly which types of resources must be represented by a JMO. JMOs themselves contain only a limited set of attributes, which are used to describe the location of the object in the data model.

Download the Java EE Management Specification from

h3 align="In the Javanding tmentnstance of comanizypentainhierarchourlresseta tree structuregementrootves a Jce="monospace">rlresrelaana.ace="monospace">

In the Java ding t Mode resource eincan browsthe obhierarchyion ntai,repcursiveresquerybLogforn model.namype

h3 align="In the Java ding tEWeb es applicati

=j2eeT by=valuy,namy=valuy,pbe nt-j2eeT by[,broperty=valuy]* abr/>Download the Java>Forns omple,ace="monospace">

Download the ing tment Specification from n tion of tsns octresdescrinamy/valuyJpairs must bti

In the Javanding tment model.nameeforn Web choldves ited seinnamy/valuyJpairs from ias pbe ntenta'ithmodel.namy. Forns omple,aie dataMan forndype is rapplicati

="0 >In the Javanding t on/p>

In the Java ding tmentnamy/valuyJpairs can reea rape

h3 align="In the Java ing tment Specification from n, is s>n t1.0,repquieprionres oatiWeb resourcen tpe is s imple fromntai and brovid< API access to dataMans1em">

In the Java ding tOpce eally, you can imple fromdataMans to brovid< performd atiplitistics, md APIs