19 WebLogic Server Diagnostics
This chapter includes the following sections:
Create diagnostic system modules
To create a new diagnostic system module:
For more information about these fields, see Configuration Options.
Parent topic: WebLogic Server Diagnostics
Monitor diagnostic system modules
To monitor the diagnostic system modules in a domain:
Optionally, select View to access the following table options:
-
Columns: add or remove the columns displayed in the table
-
Detach: detach the table (viewing option)
-
Sort: sort the columns in ascending or descending order
-
Reorder: change the order of the columns displayed
-
Query by Example
Parent topic: WebLogic Server Diagnostics
Control and configure diagnostic system modules
This section includes the following tasks:
- Control a diagnostic system module
- Define general configuration settings
- Configure collected metric settings
- Create a new collected metric
- Configure a collected metric
- Configure policies and actions
- Select targets for a diagnostic system module
Parent topic: WebLogic Server Diagnostics
Control a diagnostic system module
To control a diagnostic system module.
Parent topic: Control and configure diagnostic system modules
Define general configuration settings
To define general configuration settings for a specific diagnostic system module:
Parent topic: Control and configure diagnostic system modules
Configure collected metric settings
To configure collected metrics for the policies and actions for a specific diagnostic system module:
Parent topic: Control and configure diagnostic system modules
Create a new collected metric
To create a new collected metric:
- From the WebLogic Domain menu, select Diagnostics, then select Diagnostic Modules.
- In the Diagnostics Modules table, select the diagnostic system module you want to configure.
- Select Configuration, then select Collected Metrics.
- Click Create.
- Define the configuration options for your collected metric on each page of the following sections.
- Then, click Create to complete the creation of your new collected metric.
Parent topic: Control and configure diagnostic system modules
Collection Properties
On the Collection Properties page, define the general metric connection properties:
-
MBean Server Location: select the WebLogic Server MBean server for the metric you wish to configure. You can select either ServerRuntimeMBean or DomainRuntimeMBean.
-
Select an MBean type from the following list: select this option if you want to use a preexisting WebLogic Server MBean. From the menu, select the WebLogic Server MBean from which you want to collect data.
-
Enter a custom MBean type: select this option if you want to enter a custom MBean type.
For more information on these fields, see Configuration Options.
Parent topic: Create a new collected metric
Additional Metric Collection Properties
On the Additional Metric Connection Properties page, you can select individual MBeans to monitor. In the Collected Attributes section, select one or more attributes from the Available list. Click the right arrow button to move them to the Chosen list.
In the Attribute Expressions field, you can enter attribute expressions to collect complex or nested attributes. Start a new line for each expression.
Parent topic: Create a new collected metric
Select Instances
On the Select Instances page, you can select individual MBeans to monitor. In the Collected Instances section, select one or more instances from the Available list. Click the right arrow button to move the instances to the Chosen list.
In the Instance Expressions field, you can enter instance expressions. Start a new line for each expression.
Parent topic: Create a new collected metric
Configure a collected metric
This section describes how to configure a collected metric.
This section includes the following tasks:
Parent topic: Control and configure diagnostic system modules
Configure general settings
To configure general settings for a metric:
Parent topic: Configure a collected metric
Configure instance settings
To configure instance settings for a metric:
Parent topic: Configure a collected metric
Configure policies and actions
To configure policies and actions for a diagnostic system module:
Monitor policies
To monitor the policies configured in a diagnostic system module.
On the Policies page, you can also click Create to create a new policy for this diagnostic system module. For more information see Create a new policy. To configure a policy, select a policy from the table. See Configure a policy.
Parent topic: Configure policies and actions
Monitor actions
To monitor the actions configured in a diagnostic system module.
On the Actions page, you can also click Create to create a new action for this diagnostic system module. For more information see Create a new action. To configure an action, select an action from the table. See Configure an action.
Parent topic: Configure policies and actions
Select targets for a diagnostic system module
To specify the WebLogic Server instances and clusters to which you want to deploy this diagnostic system module:
Parent topic: Control and configure diagnostic system modules
Create and configure policies and actions
This section describes how to create policies and actions for a diagnostic system module.
This section includes the following tasks:
Parent topic: WebLogic Server Diagnostics
Create a new policy
To create a new policy for a specific diagnostic system module:
- From the WebLogic Domain menu, select Diagnostics, then select Diagnostic Modules.
- In the Diagnostics Modules table, select the diagnostic system module you want to configure.
- Select Configuration, then select Policies and Actions, then select Policies.
- Click Create.
- Define the configuration options for your policy on each page of the following sections.
- Then, click Create to complete the creation of your new policy.
Parent topic: Create and configure policies and actions
Policy Configuration
On the Policy Configuration page, define the general policy configuration settings for your new policy:
-
Policy Name: enter a name for the policy.
-
Rule Type: select a rule from the Rule Type menu.
-
Select Calendar Based to set a rule based on a set schedule.
-
Select Collected Metrics to set a rule based on metrics collected from MBean attributes.
-
Select Domain Log to set a rule based on data written to the domain log.
-
Select Event Data to set a rule based on data generated from a specified instrumentation event.
-
Select Server Log to set a rule based on data written to server logs.
-
Select Smart Rule Based to set a rule based on a built-in Smart Rule.
-
-
Enabled: select the Enabled checkbox if you want to enable this policy.
For more information on these fields, see Configuration Options.
Parent topic: Create a new policy
Expression/Smart Rule
On the Expression/Smart Rule page, assign a policy expression to this policy by either selecting a built-in smart rule or building a new expression.
-
To assign a policy expression to this policy using a built-in smart rule, select Smart Rule and select the desired smart rule from the menu. After you choose a smart rule, the smart rule description is displayed as well as a table listing and describing the arguments for the selected smart rule. Enter the appropriate argument values in the Value fields.
-
To build a new expression for this policy, select Expression and enter your new policy expression.
For more information on these fields, see Configuration Options.
Parent topic: Create a new policy
Schedule
On the Schedule page, set the schedule for this policy.
-
Start Time: set the start time for this policy using the Hour, Minute, and Second fields. Also, specify the time of day by selecting AM or PM.
-
Repeat: select a schedule for this policy from the menu.
-
Select Every N seconds to set the policy to execute every N seconds.
-
Select Every N minutes to set the policy to execute every N minutes.
-
Select Every N hours to set the policy to execute every N hours.
-
Select Specific days of the week to set the policy to execute at the same time on the specified days.
-
Select Specific days of the month to set the policy to execute at the same time on the specified days.
-
-
Frequency: specify a frequency for this policy's schedule. The acceptable values for this field change based on the schedule you selected in the Repeat field.
-
If you selected Every N seconds, Every N minutes, or Every N hours in the Repeat field, then specify the appropriate value in the Frequency field. You can also use the up and down arrows to select the desired value. For example, if you selected Every N minutes in the Repeat field, and you want your policy to execute every 30 minutes, enter
30
in the Frequency field. -
If you selected Specific days of the week in the Repeat field, then select the checkboxes for the appropriate days in the Frequency field. For example, select the checkboxes for Wednesday and Friday to schedule your policy to execute every Wednesday and Friday.
-
If you selected Specific days of the month in the Repeat field, then select the checkboxes for the appropriate dates in the Frequency field. For example, select the checkboxes for 15 and 20 to schedule your policy to execute on the 15th and 20th of the month.
-
For more information on these fields, see Configuration Options.
Parent topic: Create a new policy
Alarms
On the Alarms page, specify an alarm and the alarm's reset settings for your policy:
-
Policy Alarm: select an alarm reset setting for your policy. You can select Do not use an alarm, Use a manual reset alarm, or Use an automatic reset alarm.
-
Automatic Reset Period (in seconds): if you selected Use an automatic reset alarm as the Policy Alarm setting, enter the automatic reset period, in seconds, for the alarm. This reset period is the time period to wait after the policy evaluates to
true
before the alarm is automatically reset. This value is converted to milliseconds before it is stored. For example, if you enter 50 seconds, it is stored as 50000 milliseconds. The default reset period is 60000 milliseconds, or 60 seconds. The minimum value you can set is 1 second (1000 ms).
For more information on these fields, see Configuration Options.
Parent topic: Create a new policy
Actions
On the Actions page, you can assign scaling and other actions to your policy:
-
Scale Up Action: assign a scale up action to the policy. For more information on creating a scale up action, see Create a scale up or scale down action.
Note:
You can assign only one scaling action, either a scale up or a scale down action, to a policy. You can assign any number of non-scaling actions.
-
Scale Down Action: assign a scale down action to the policy. For more information on creating a scale down action, see Create a scale up or scale down action.
-
Diagnostic Actions: select the actions (not including scaling actions) that you want to assign to your policy by moving them from the Available column to the Chosen column.
For more information on these fields, see Configuration Options.
Parent topic: Create a new policy
Configure a policy
Policies are monitors that observe specific diagnostic state and can be configured to send one or more actions based on configured rules.
This section includes the following tasks:
- Configure general policy settings
- Configure policy expressions
- Configure policy schedule settings
- Configure policy alarm settings
- Assign actions to a policy
Parent topic: Create and configure policies and actions
Configure general policy settings
To define general settings for a policy:
Parent topic: Configure a policy
Configure policy expressions
To define policy expressions for a policy:
Parent topic: Configure a policy
Configure policy schedule settings
To define schedule settings for a policy:
Parent topic: Configure a policy
Configure policy alarm settings
To define alarm settings for a policy:
Parent topic: Configure a policy
Create a new action
To create a new action for a specific diagnostic system module:
- From the WebLogic Domain menu, select Diagnostics, then select Diagnostic Modules.
- In the Diagnostics Modules table, select the diagnostic system module you want to configure.
- Select Configuration, then select Policies and Actions, then select Actions.
- Click Create and select the type of action you want to create. You can create the following action types:
- Create a SMTP (e-mail) action
- Create a JMS message action
- Create a diagnostic image action
- Create a JMX notification action
- Create a SNMP trap action
- Create a REST action
- Create a scale up or scale down action
Parent topic: Create and configure policies and actions
Create a SMTP (e-mail) action
To create a new SMTP (e-mail) action:
Parent topic: Create a new action
Create a diagnostic image action
To create a new diagnostic image action:
Parent topic: Create a new action
Create a JMX notification action
To create a new JMX notification action:
Parent topic: Create a new action
Create a scale up or scale down action
The section describes how to create a new scale up or scale down action.
Note:
creating a scaling action requires a dynamic cluster.
To create a new scale up action:
-
From the WebLogic Domain menu, select Diagnostics, then select Diagnostic Modules.
-
In the Diagnostics Modules table, select the diagnostic system module you want to configure.
-
Select Configuration, then select Policies and Actions, then select Actions.
-
Click Create and select Scale Up from the menu.
-
On the Create an Action: Scale Up page, you can define configuration settings for this action, such as:
-
Action Name
-
Timeout (in seconds)
-
Enable Action
-
Service Name
-
Scale Type
-
Current Cluster Size
-
Maximum Cluster Size
-
Minimum Cluster Size
-
Desired Server Count
For more information on these fields, see Configuration Options.
-
-
Click Create.
To create a new scale down action:
Parent topic: Create a new action
Configure an action
This section includes the following tasks:
- Configure a SMTP action
- Configure a JMS message action
- Configure a diagnostic image action
- Configure a JMX notification action
- Configure a SNMP trap action
- Configure a REST action
- Configure a scale up action
- Configure a scale down action
Parent topic: Create and configure policies and actions
Configure a diagnostic image action
To configure a diagnostic image action:
Parent topic: Configure an action
Configure a JMX notification action
To configure a JMX notification action:
Parent topic: Configure an action
Monitor diagnostic images
The diagnostic image functionality provided by the WebLogic Server Diagnostic Service gathers the most common sources of key server state used in diagnosing problems and packages that state into a single file, or "diagnostic image." You can specify the default destination directory where diagnostic images for a server are saved, and you can initiate an immediate capture of an image for a server.
To monitor the diagnostic images in a domain:
Parent topic: WebLogic Server Diagnostics
Download captured diagnostic images
To download a captured diagnostic image:
Parent topic: Monitor diagnostic images