Skip navigation.
Downloads | Product Documentation | Support

Administration Console Online Help

# Configure metrics to collect in a diagnostic system module

Before you begin

Create diagnostic system modules

To configure metrics to collect in a diagnostic system module, you must first create a diagnostic system module and target it to the server(s) whose performance you want to monitor. You then select MBeans and their attributes that you want to monitor in the running server. A module is likely to contain multiple metrics, each based on the selected MBean attribute values of the selected MBean type and possibly restricted to a given MBean instance.

You can create metrics that monitor:

- All attributes or specified attributes of an MBean type.
- All instances or specified instances of an MBean type.

To configure metrics to be collected:

1. If you have not already done so, in the Change Center of the Administration Console, click Lock & Edit (see Use the Change Center).
2. In the left pane, expand Diagnostics and select Diagnostic Modules.
3. On the Summary of Diagnostic Modules page, click the name of the module for which you want to configure metrics.
4. On the Settings for [Module Name] page, select Configuration > Collected Metrics.
5. On the Configuration tab, click Collected Metrics.
6. Under Collected Metrics in this Module, click New.
7. Under Metric Collection Properties, select an MBean you want to monitor from the MBean Type list. Then click Next.
8. To select individual attributes on the MBean you chose above, skip to step 9, below. To select all available attributes on the MBean, do one of the following.
   1. Click Finish to select all attributes on this MBean type for all instances of the MBean. If you click Finish here, the process for configuring this metric is complete.
   2. Click Next if you want to select specific instances of this MBean type. Skip to step 10, below.
9. To select individual MBean attributes to monitor:
   1. In the Collected Attributes section, select one or more attributes from the Available list. (Ctrl-click to select multiple, nonadjacent attributes; Shift-click to select multiple, adjacent attributes.)
   2. Click the right arrow button to move the attributes to the Chosen list. To move an item in the Chosen list back to the Available list, select the item from the Chosen list and click the left arrow button .
   3. Click Finish to select the attributes on this MBean type for all instances of the MBean, or click Next to select specific instances of this MBean type. If you click Finish here, the process for configuring this metric is complete. If you click Next, go step 10, below.
10. If instances of the MBean type already exist, you can select the ones for which you want to collect metrics, as follows:
    1. In the Collected Instances section, select one or more instances from the Available list.
    2. Click the right arrow button to move the instances to the Chosen list. (Ctrl-click to select multiple, nonadjacent attributes; Shift-click to select multiple, adjacent attributes.) To move an item in the Chosen list back to the Available list, select the item from the Chosen list an click the left arrow button
    3. Click Finish. If you click Finish without choosing any instances, all instances are chosen, including instances that are created in the future.
11. Click Save.
12. To activate these changes, in the Change Center of the Administration Console, click Activate Changes.
    Not all changes take effect immediately—some require a restart (see Use the Change Center).

After you finish

- To enable metric collection for all the metrics created for this module, make sure that the Enabled box is selected on the Collected Metrics tab (the page from which you clicked New to create the new metric). Then click Save.
- To enable or disable metric collection for individual metrics, go to the Configuration page for the metric and select or deselect the Enable Metric box. The metric is enabled by default when you first create it.