Runtime APIs Configuration and Runtime APIs

16-6 Configuring and Using the Diagnostics Framework for Oracle WebLogic Server

16.3.1.2 Runtime APIs

The runtime APIs define interfaces that are used to monitor the runtime state of the WLDF components. Instances of these APIs are instantiated on instances of individually managed servers. These APIs are defined as runtime MBeans, so JMX clients can easily access them. The Runtime APIs encapsulate all other runtime interfaces for the individual WLDF components. These APIs are included in the weblogic.management.runtime package. You can use the runtime APIs to monitor the following WLDF components: ■ Data Collectors—You can use the runtime APIs to monitor the Instrumentation, Harvester, and the Image Capture components. – For the Instrumentation component, you can monitor joinpoint count statistics, the number of classes inspected for instrumentation monitors, the number of classes modified, and the time it takes to inspect a class for instrumentation monitors. – For the Harvester component, you can query the set of harvestable types, harvestable attributes, and harvestable instances that is, the instances that are currently harvestable for specific types. And, you can also query which types, attributes, and instances are currently configured for harvesting. The sampling interval and various runtime statistics pertaining to the harvesting process are also available. – For the Image Capture component, you can specify the destination and lockout period for diagnostic images and initiate image captures. ■ Watches and Notifications: You can use the runtime APIs to monitor the Watches and Notifications and Archive components. – For the Watches and Notifications component, you can reset watch alarms and monitor statistics about watch-rule evaluations and watches triggered, including information about the analysis of alarms, events, log records, and harvested metrics. ■ Archive: You can monitor information about the archive, such as file name and archive statistics. ■ Data Accessor—You can use the runtime APIs to retrieve the diagnostic data persisted in the different archives. The runtime APIs also support data filtering by allowing you to specify a query expression to search the data from the underlying archive. You can monitor information about column type maps a map relating column names to the corresponding type names for the diagnostic data, statistics about data record counts and timestamps, and cursors cursors are used by clients to fetch data records.

16.4 WLDF Packages