Configuring WLDF Watch and Notification for the Diagnostic Framework

13-16 Oracle Fusion Middleware Administrators Guide Problem Id Problem Key 1 BEA-101020 [HTTP]

13.4.2.2 Viewing Incidents

You can list of all available incidents or the incidents related to a specific problem by executing the WLST listIncidents command, using the following format: listIncidents[id], [ADRHome] For example, to see the list of all incidents, use the following command: listIncidents Incident Id Problem Key Incident Time 2 BEA-101020 [HTTP] Fri Feb 26 13:42:01 PDT 2010 1 BEA-101020 [HTTP] Tue Feb 23 06:17:39 PDT 2010 To view the incidents related to a specific problem, use the following command: listIncidentsid=1 Incident Id Problem Key Incident Time 2 BEA-101020 [HTTP] Fri Feb 26 13:42:01 PDT 2010 1 BEA-101020 [HTTP] Tue Feb 23 06:17:39 PDT 2010 To view the details of a particular incident, use the WLST showIncident command, using the following format: showIncidentid, [adrHome] [,server] For example, to see the details of incident 1, use the following command: showIncidentid=1 Incident Id: 1 Problem Id: 1 Problem Key: BEA-101020 [HTTP] Incident Time: Tue Feb 23 06:17:39 PDT 2010 Error Message Id: BEA-101020 Execution Context: 0000IExqUvyAhKB5JZ4Eyf1Afdj600009i Flood Controlled: false Dump Files : dms_ecidctx1_i1.dmp jvm_threads2_i1.dmp dms_metrics3_i1.dmp odl_logs4_i1.dmp odl_logs5_i1.dmp diagnostic_image_AdminServer_2010_02_23_06_17_42.zip readme.txt To view the contents of a file in the incident, use the WLST getIncidentFile command, using the following format: getIncidentFileid, name [,outputFile] [,adrHome] [,server] For example, to view the contents for the file odl_logs4_i1.dmp use the following command: getIncidentFileid=1, name=odl_logs4_i1.dmp, outputFile=tmpodl_logs4_i1_ dmp.output The command writes the output to the file odl_logs4_i1_dmp.output. Diagnosing Problems 13-17

13.4.3 Working with Diagnostic Dumps

If you suspect a problem, you can make use of the built-in diagnostic dumps to report detailed diagnostics that can help diagnose the problem. Diagnostic dumps provide a means to output and record diagnostics data which serve as valuable information when diagnosing issues with Oracle Fusion Middleware components, applications, and infrastructure. The output from these dumps is intended to be used by customers and Oracle Support to diagnose issues with Oracle Fusion Middleware. Diagnostic dumps are executed in the following ways: ■ Manually, using WLST commands, as described in the following sections For example, if your Java EE application is hanging and you suspect a deadlock, you could use the jvm.threads dump to obtain the set of threads. ■ Automatically, when the Diagnostic Framework detects a critical error and creates an incident or when the administrator creates an incident

13.4.3.1 Listing Diagnostic Dumps

You can find a list of diagnostic dumps that are available for a Managed Server by executing the WLST listDumps command, using the following format: listDumps[appName] [,server] For example, to list the available dumps for soa_server1: listDumpsserver=soa_server1 Location changed to domainRuntime tree. This is a read-only tree with DomainMBean as the root. For more help, use helpdomainRuntime odl.activeLogConfig jvm.classhistogram dms.ecidctx wls.image odl.logs dms.metrics odl.quicktrace http.requests jvm.threads Use the command describeDumpname=dumpName for help on a specific dump. Table 13–2 lists the diagnostic dump actions that are defined by Oracle Fusion Middleware and their descriptions. Table 13–2 Diagnostic Dump Actions Dump Action Description dms.ecidctx The data associated with a specific Execution Context ID ECID, if specified. Otherwise, the data associated with all available ECIDs. dms.metrics Dynamic Monitoring Service DMS metrics. For information about these metrics, see About Dynamic Monitoring Service DMS in the Oracle Fusion Middleware Performance and Tuning Guide. http.requests A summary of the currently active HTTP requests. 13-18 Oracle Fusion Middleware Administrators Guide

13.4.3.2 Viewing a Description of a Diagnostic Dump

You can view a description of a particular dump, including the syntax for executing the dump by using the WLST describeDump command. You specify the name of the dump in which you are interested. For example, to view a description of the dms.metrics dump, use the following command: describeDumpname=dms.metrics Name: dms.metrics Description: Dumps DMS Dynamic Monitoring Service metrics. Mandatory Arguments: Optional Arguments: Name Type Description format STRING Format of the dump output; raw or xml

13.4.3.3 Executing Dumps

If you detect a problem and want to gather additional diagnostic data, you can invoke the executeDump command for a specified dump. Each dump may have mandatory or optional arguments, or both. To view the arguments for a particular dump and how to specify them, use the describeDump command, as described in Section 13.4.3.2 . The following example executes the dump with the name dms.metrics and the incident ID 1 and writes it to the file dumpout.txt: executeDumpname=dms.metrics, outputFile=tmpdumpout.txt, id=1 Dump file dms_metrics1_i1.dmp added to incident 1 The command writes the dump output to the information about incident 1. If you execute the showIncident command for incident 1, the output includes dms_metrics1_ i1.dmp.

13.4.4 Managing Incidents

The Diagnostic Framework stores incidents, whether they are created automatically or manually, and Oracle Fusion Middleware provides tools to help you process incident reports and to package those incidents to send to Oracle Support. The following sections describe: ■ Creating an Incident Manually ■ Packaging an Incident ■ Generating an RDA Report ■ Purging Incidents jvm.classhistogram A JVM class histogram, the output of which varies depending on the JVM vendor. jvm.threads Summary statistics about the threads running in a JVM as well as performing a full thread dump. odl.activeLogConfig The active Java logging configuration. odl.logs Contents of diagnostic logs, correlated by ECID or time range. odl.quicktrace Quick trace messages. wls.image The WLDF server image dump. Table 13–2 Cont. Diagnostic Dump Actions Dump Action Description