1-4 Configuring and Using the Diagnostics Framework for Oracle WebLogic Server
1.4 Related Documentation
■
Configuring Log Files and Filtering Log Messages for Oracle WebLogic Server describes how to use WLDF logging services to monitor server, subsystem, and application
events.
■
Configure the WebLogic Diagnostics Framework in the Administration Console Online Help describes how to use the visual tools in the WebLogic Administration
Console to configure WLDF.
■
The WLDF system resource descriptor conforms to the weblogic-diagnostics.xsd schema, available at
http:xmlns.oracle.comweblogicweblogic-diagnostics1.0web logic-diagnostics.xsd
.
1.5 Samples and Tutorials
In addition to this document, we provide a variety of samples and tutorials that show WLDF configuration and use.
1.5.1 Avitek Medical Records Application MedRec and Tutorials
MedRec is an end-to-end sample J2EE application shipped with WebLogic Server that simulates an independent, centralized medical record management system. The
MedRec application provides a framework for patients, doctors, and administrators to manage patient data using a variety of different clients.
MedRec demonstrates WebLogic Server and J2EE features, and highlights recommended best practices. MedRec is included in the WebLogic Server distribution,
and can be accessed from the Start menu on Windows machines. For Linux and other platforms, you can start MedRec from the WL_HOME\samples\domains\medrec
directory, where WL_HOME is the top-level installation directory for WebLogic Platform.
1.5.2 WLDF Samples Available for Download
Additional WLDF samples for download can be found at https:www.samplecode.oracle.comsfprojectscodesamples
. These examples are distributed as .zip files that you can unzip into an existing WebLogic
Server samples directory structure. These samples include Oracle-certified ones, as well as samples submitted by fellow developers.
1.6 New and Changed Features in this Release
Two diagnostic monitors have been added:
■
JDBC_After_Reserve_Connection_Internal
■
JDBC_After_Release_Connection_Internal These diagnostic instrumentation monitors can be configured in a WLDF module at
the server level. They provide additional visibility when JDBC connections are reserved and released. For more information, see
Section B.1, Diagnostic Monitor Library.
For a comprehensive listing of the new WebLogic Server features introduced in this release, see Whats New in Oracle WebLogic Server.
2
Overview of the WLDF Architecture 2-1
2
Overview of the WLDF Architecture
The WebLogic Diagnostics Framework WLDF consists of a number of components that work together to collect, archive, and access diagnostic information about a
WebLogic Server instance and the applications it hosts. This section provides an architectural overview of those components.
The WLDF architecture is described in the following sections:
■
Section 2.1, Overview of the WebLogic Diagnostics Framework
■
Section 2.2, Data Creation, Collection, and Instrumentation
■
Section 2.3, Archive
■
Section 2.4, Watch and Notification
■
Section 2.5, Data Accessor
■
Section 2.6, Monitoring Dashboard and Request Performance Pages
■
Section 2.7, Diagnostic Image Capture
■
Section 2.8, How It All Fits Together
2.1 Overview of the WebLogic Diagnostics Framework
WLDF consists of the following:
■
Data creators data publishers and data providers that are distributed across WLDF components
■
Data collectors the Logger and the Harvester components
■
Archive component
■
Accessor component
■
Instrumentation component
■
Watch and Notification component
■
Image Capture component
Note: Concepts are presented in this section in a way to help you
understand how WLDF works. Some of this differs from the way WLDF is surfaced in its configuration and runtime APIs and in the
WebLogic Server Console. If you want to start configuring and using WLDF right away, you can safely skip this discussion and start with
Chapter 4, Understanding WLDF Configuration.
2-2 Configuring and Using the Diagnostics Framework for Oracle WebLogic Server
■
Monitoring Dashboard Data creators generate diagnostic data that is consumed by the Logger and the
Harvester. Those components coordinate with the Archive to persist the data, and they coordinate with the Watch and Notification subsystem to provide automated
monitoring. The Accessor interacts with the Logger and the Harvester to expose current diagnostic data and with the Archive to present historical data. The Image
Capture facility provides the means for capturing a diagnostic snapshot of a key server state. The relationship among these components is shown in
Figure 2–1 .
Figure 2–1 Major WLDF Components
All of the framework components operate at the server level and are only aware of server scope. All the components exist entirely within the server process and
participate in the standard server lifecycle. All artifacts of the framework are configured and stored on a per server basis.
2.2 Data Creation, Collection, and Instrumentation