Administration Console Online Help

Previous Next Open TOC in new window
Content starts here

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:

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. From the MBean Server Location drop-down, select either DomainRuntime or ServerRuntime. Then click Next.
  8. Under Metric Collection Properties, select an MBean you want to monitor from the MBean Type list. Then click Next.
  9. To select individual attributes on the MBean you chose above, skip to step 10, 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 11, below.
  10. 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 11, below.

      Note: You can specify nested or complex attributes in an attribute expression. See Using Wildcards in Expressions for more information.

  11. 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.

      Note: You can use wildcards in harvester instance names. See Using Wildcards in Expressions for more information.

  12. Click Save.
  13. 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.

Back to Top