Configuring WLDF Diagnostic Volume WLST Commands for Generating an Image Capture

5-2 Configuring and Using the Diagnostics Framework for Oracle WebLogic Server ■ WLDF diagnostics volume, which determines the volume of WebLogic Server event information that is captured in the Flight Recorder file. As with other WLDF components, you can configure Diagnostic Image Capture using the Administration Console see Configure and capture diagnostic images in the Oracle WebLogic Server Administration Console Help, the WebLogic Scripting Tool WLST, or programmatically.

5.2.1 Configuring WLDF Diagnostic Volume

If WebLogic Server is configured with Oracle JRockit, and the JRockit Flight Recorder is enabled, JRockit Flight Recorder data is automatically also captured in the diagnostic image capture. This data can be extracted from the diagnostic image capture and viewed in JRockit Mission Control. If JRockit Flight Recorder is not enabled, or if WebLogic Server is configured with a different JVM, the Flight Recorder data is not captured in the diagnostics image capture. The volume of Flight Recorder data that is captured can be configured from the WebLogic Server Administration Console, which allows you to specify the following settings: ■ Off — No data is captured in the Flight Recorder diagnostic image. ■ Low — Default. Basic information is captured when messages with the emergency, alert, or critical levels are recorded. ■ Medium — Additional information is captured when messages with the error level and above are recorded. ■ High — In-depth information is captured when messages with the error level and above are recorded. For information about how to set the volume of data that is captured, see Configure WLDF diagnostics volume in the Oracle WebLogic Server Administration Console Help.

5.2.2 WLST Commands for Generating an Image Capture

Example 5–1 shows an example of WLST commands for generating an image capture. Note: It is often useful to generate a diagnostic image capture when a server fails. To do so, set a watch rule to evaluate to true when the servers state changes to FAILED; then associate an image notification with the watch. The watch rule is as follows: {[weblogic.management.runtime.ServerRuntimeMBean] State} = FAILED For more information, see Section 9.3, Configuring Harvester Watches, and Section 10.6, Configuring Image Notifications. Also see Configure Watches and Notifications in the Oracle WebLogic Server Administration Console Help. Note: The default setting for the WLDF diagnostic volume is Low. Configuring and Capturing Diagnostic Images 5-3 Example 5–1 Sample WLST Commands for Generating a Diagnostic Image url=t3:localhost:7001 username=system password=gumby1234 server=myserver timeout=120 connectusername, password, url serverRuntime cdWLDFRuntimeWLDFRuntimeWLDFImageRuntimeImage argTypes = jarray.array[java.lang.Integer],java.lang.String argValues = jarray.array[timeout],java.lang.Object invokecaptureImage, argValues, argTypes

5.3 How Diagnostic Image Capture Is Persisted in the Servers Configuration