Note:
If you are logged into a domain partition, navigate from the Domain Partition menu.
This chapter includes the following sections:
To create a new diagnostic system module:
For more information about these fields, see Configuration Options.
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
This section includes the following tasks:
To define general configuration settings for a specific diagnostic system module:
To configure collected metrics for the policies and actions for a specific diagnostic system module:
To create a new collected metric:
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.
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.
For more information, see Configuration Options.
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.
For more information, see Configuration Options.
This section describes how to configure a collected metric.
This section includes the following tasks:
To configure policies and actions for a diagnostic system module:
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. For more information, see Configure a policy.
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. For more information, see Configure an action.
This section describes how to create policies and actions for a diagnostic system module.
This section includes the following tasks:
To create a new policy for a specific diagnostic system module:
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.
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.
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.
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.
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.
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:
To create a new action for a specific diagnostic system module:
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:
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: