Oracle® Fusion Middleware WebLogic Scripting Tool Command Reference 11g Release 1 (10.3.5) E13813-10 |
|
![]() Previous |
![]() Next |
The Diagnostic Framework aids in capturing relevant and timely diagnostics for critical errors. The diagnostics can be sent to Oracle Support for further analysis. Use the Diagnostic Framework commands to generate incidents, query existing incidents and execute individual diagnostics dumps to gather specific diagnostics data.
For additional information about using the Diagnostic Framework, see "Diagnosing Problems" in the Oracle Fusion Middleware Administrator's Guide.
Note: To use the Diagnostic Framework custom WLST commands, you must invoke the WLST script from the Oracle Common home. See "Using Custom WLST Commands" in the Oracle Fusion Middleware Administrator's Guide. |
Table 15-1 lists the different categories of Diagnostic Framework commands.
Table 15-1 Diagnostic Command Categories
Command Category | Description |
---|---|
|
View problems and incidents and to create incidents. |
|
Display information about dumps and to execute dumps. |
Use the commands in Table 15-2 to view problems and incidents and to create incidents.
Table 15-2 Incident Commands
Use this command... | To... | Use with WLST... |
---|---|---|
|
Create a diagnostic incident. |
Online |
|
Retrieves the contents of the specified incident file. |
Online |
|
List the set of ADR Home paths. |
Online |
|
List a set of diagnostic incidents. |
Online |
|
List a set of diagnostic problems. |
Online |
|
Show the details of a specified incident. |
Online |
Use with WLST: Online
Creates a diagnostic incident, using the specified information to determine the set of diagnostic rules and actions to execute.
createIncident([adrHome] [,incidentTime] [,messageId] [,ecid] [,appName] [,description] [,server])
Argument | Definition |
---|---|
adrHome
|
The path for the ADR Home in which to create the incident. The ADR Home must exist. If this argument is not specified, the default ADR Home is used.
The default ADR Home is the following location: ADR_BASE/diag/OFM/domain_name/server_name |
incidentTime
|
The timestamp at which the incident occurred. If this not specified, the current time is used. You can specify the following:
|
messageId
|
The ID of the error message. For example, MDS-50400. |
ecid
|
The Execution Context ID for the error message. |
appNname
|
The name of the deployed application for which the diagnostics are being gathered.
For example, if you have multiple ADF applications deployed, each may register a dump called adf.dump. To execute this command for a specific application, you must specify the application name. |
description
|
Descriptive text to associate with the incident. This is useful when reviewing the incident at a later time. |
server
|
The name of the Managed Server from which to collect information. This argument is valid only when you are connected to the Administration Server. |
The following example creates an incident that is related to messages with the ID MDS-50400:
createIncident(messageId="MDS-50400", description="sample incident")
Incident Id: 55
Problem Id: 4
Problem Key: MDS-50400 [MANUAL]
Incident Time: 25th March 2010 11:55:45 GMT
Error Message Id: MDS-50400
Flood Controlled: false
Use with WLST: Online
getIncidentFile(id, name [,outputFile] [,adrHome] [,server])
Argument | Definition |
---|---|
id
|
The ID of the incident that you want to retrieve. |
name
|
The name of the file to retrieve. To find the name of the file, use the showIncident command. |
outputFile
|
The name of the file to which to write the output. |
adrHome
|
The path for the ADR Home from which to retrieve the information. If this argument is not specified, the default ADR Home will be queried.
The default ADR Home is the following location: ADR_BASE/diag/OFM/domain_name/server_name |
server
|
The name of the Managed Server from which to collect information. This argument is valid only when you are connected to the Administration Server. |
Use with WLST: Online
listADRHomes([server])
Argument | Definition |
---|---|
server
|
The name of the Managed Server from which to collect information. This argument is valid only when you are connected to the Administration Server. |
Use with WLST: Online
Lists the set of diagnostic incidents for the given problem ID, if specified, or all available incidents.
listIncidents([id] [, adrHome] [,server])
Argument | Definition |
---|---|
id
|
The ID of the problem for which you want to list the set of diagnostic incidents. |
adrHome
|
The path for the ADR Home from which to query incidents. If this argument is not specified, the default ADR Home will be queried.
The default ADR Home is the following location: ADR_BASE/diag/OFM/domain_name/server_name |
server
|
The name of the Managed Server from which to collect information. This argument is valid only when you are connected to the Administration Server. |
The following example lists the incidents associated with the problem with the ID 1
:
listIncidents(id="1")
Incident Id Problem Key Incident Time
10 MDS-50300 [WLS_Spaces] [oracle.mds.repos] Mon Mar 15 11:22:12 PDT 2010
24 MDS-50300 [WLS_Spaces] [oracle.mds.repos] Thu Mar 11 15:11:35 PDT 2010
Use with WLST: Online
listProblems([adrHome][,server])
Argument | Definition |
---|---|
adrHome
|
The path for the ADR Home from which to query problems. If this argument is not specified, the default ADR Home will be queried.
The default ADR Home is the following location: ADR_BASE/diag/OFM/domain_name/server_name |
server
|
The name of the Managed Server from which to collect information. This argument is valid only when you are connected to the Administration Server. |
Use with WLST: Online
showIncident(id, [adrHome][, server])
Argument | Definition |
---|---|
id
|
The ID of the incident that you want to view. |
adrHome
|
The path for the ADR Home from which to query the incident. If this argument is not specified, the default ADR Home will be queried.
The default ADR Home is the following location: ADR_BASE/diag/OFM/domain_name/server_name |
server
|
The name of the Managed Server from which to collect information. This argument is valid only when you are connected to the Administration Server. |
The following example displays information about the incident with the ID 10:
showIncident(id="10")
Incident Id: 10
Problem Id: 1
Problem Key: MDS-50300 [WLS_Spaces] [oracle.mds.repos]
Incident Time: 25th March 2010 10:12:15 GMT
Error Message Id: MDS-50300
Execution Context: 0000ICK4rbYC8xT6uBf9EH1AX1qF000000
Flood Controlled: false
Dump Files :
dms_ecidctx1_i1.dmp
jvm_threads2_i1.dmp
dms_metrics3_i1.dmp
odl_logs4_i1.dmp
diagnostic_image_AdminServer_2010_03_25_11_12_15.zip
readme.txt
Use the commands in Table 15-3 to display information about dumps and to execute dumps.
Table 15-3 Diagnostic Dump Commands
Use this command... | To... | Use with WLST... |
---|---|---|
|
Display a description of the specified diagnostic dump. |
Online |
|
Execute the specified diagnostic dump. |
Online |
|
Display the set of diagnostic dumps that can be executed. |
Online |
Use with WLST: Online
describeDump(name [,appName] [.server])
Argument | Definition |
---|---|
name
|
The name of the dump for which to display information. |
appName
|
The name of the deployed application for which information is gathered.
For example, if you have multiple ADF applications deployed, each may register a dump called adf.dump. To execute this command for a specific application, you must specify the application name. |
server
|
The name of the Managed Server from which to collect information. This argument is valid only when you are connected to the Administration Server. |
The following example displays information about the dump with the name odl.logs. You use the listDumps command to retrieve the list of available dumps.
describeDump(name="odl.logs")
Name: odl.logs
Description: Dumps recent ODL logs, or logs correlated by ECID
Manadatory Arguments:
Optional Arguments:
Name Type Description
ECID String Execution Context Id to correlate log entries with
timestamp String Timestamp to query logs 5 minutes before/after
Use with WLST: Online
executeDump(name [,args] [,outputFile] [,id] [,adrHome] [,server])
Argument | Definition |
---|---|
name
|
The name of the diagnostic dump to execute. |
args
|
Mandatory or optional arguments to pass to the dump. |
outputFile
|
The name of the file to which to write the dump. If you do not specify this argument, the output is written to the console. |
id
|
The ID of the incident to which to associate the dump. By default, the specified dump will not be associated with an incident. |
adrHome
|
The ADR home that contains the incident. If you do not specify this argument, the default ADR home is used.
The default ADR Home is the following location: ADR_BASE/diag/OFM/domain_name/server_name |
server
|
The name of the Managed Server from which to collect information. This argument is valid only when you are connected to the Administration Server. |
Arguments that are either required or are optional can be specified using the "args" keyword. For example:
executeDump("java.sysprops",args={"prop" : "os.name"})
The following example executes the dump with the name jvm.threads and writes it to the file dumpout.txt:
executeDump(name="jvm.threads", outputFile="/tmp/dumpout.txt")
Diagnostic dump jvm.threads output written to /tmp/dumpoutput.txt
The following example executes the dump with the name jvm.threads and the Incident ID for 33 and writes it to the file dumpout.txt:
executeDump(name="jvm.threads", outputFile="/tmp/dumpout.txt", id="33")
Diagnostic dump jvm.threads output associated with incident 33 in ADR Home diag/ofm/base_domain/AdminServer
The following example executes a dump with the argument prop
set to the value os.name
:
executeDump("java.sysprops",args={"prop" : "os.name"})
Use with WLST: Online
listDumps([appName] [,server])
Argument | Definition |
---|---|
appName
|
The name of a deployed application for which diagnostics are being gathered.
For example, if you have multiple ADF applications deployed, each may register a dump called adf.dump. To execute this command for a specific application, you must specify the application name. If you specify this argument, the command returns the dumps for the specified application. If you do not specify this argument, the command returns the system dumps. |
server
|
The name of the Managed Server from which to collect information. This argument is valid only when you are connected to the Administration Server. |