Configuration APIs Configuration and Runtime APIs

Configuring and Using WLDF Programmatically 16-5 – Capture notifications using JMS. – Retrieve archived data through the Accessor. The Accessor, as are the other components, is surfaced as JMX; you can use WLST or straight JMX programming to retrieve diagnostic data.

16.3.1 Configuration and Runtime APIs

The configuration and runtime APIs configure and monitor WLDF. Both the configuration and runtime APIs are exposed as MBeans. ■ The configuration MBeans and system module Beans create and configure WLDF resources, and determine their runtime behavior. ■ The runtime MBeans monitor the runtime state and the operations defined for the different components. You can use the APIs to configure, activate, and deactivate data collection; to configure watches, notifications, alarms, and diagnostic image captures; and to access data.

16.3.1.1 Configuration APIs

The Configuration APIs define interfaces that are used to configure the following WLDF components: ■ Data Collectors: You can use the configuration APIs to configure and control Instrumentation, Harvesting, and Image Capture. – For the Instrumentation component, you can enable, disable, create, and destroy server-level instrumentation and instrumentation monitors. – For the Harvester component, you can add and remove types to be harvested, specify which attributes and instances of those types are to be harvested, and set the sample period for the harvester. – For the Diagnostic Image Capture component, you can set the name and path of the directory in which the image capture is to be stored and the events image capture interval, that is, the time interval during which recently archived events are captured in the diagnostic image. ■ Watch and Notifications: You can use the configuration APIs to enable, disable, create, and destroy watches and notifications. You can also use the configuration APIs to: – Set the rule type, watch-rule expressions, and severity for watches – Set alarm type and alarm reset period for notifications – Configure a watch to trigger a diagnostic image capture – Add and remove notifications from watches ■ Archive: Set the archive type and the archive directory Note: The configuration APIs do not support configuration of application-level instrumentation. However, configuration changes for application-level instrumentation can be effected using Java Specification Request JSR 88 APIs. 16-6 Configuring and Using the Diagnostics Framework for Oracle WebLogic Server

16.3.1.2 Runtime APIs