test

Sun Java Enterprise System 5 Monitoring Guide

Using the Monitoring Console

The procedures in this section describe how to interact with the Monitoring Console.

ProcedureTo Selectively Disable and Re-Enable Monitoring

The Java ES monitoring mechanisms are designed to be lightweight in order to not impact the performance of production systems. However, in certain cases it is desirable to stop collecting monitoring values so that the instrumentation has nearly zero impact on performance. The Monitoring Console provides a way to do this on a host-by-host basis, as described in the following procedure.

  1. If necessary, navigate to the Deployment level display by clicking the “Deployment” link at the root of the hierarchy in the left-hand side of the Monitoring Console. Then click on the Hosts tab in the right-hand pane.

    The Hosts tab showing the table of hosts and the controls for selecting and disabling a host.

    The table on the Hosts tab lists all of the hosts containing Java ES component that are monitored by the Monitoring Console.

  2. Use the checkboxes in the left-hand column of the table to select all hosts that you wish stop monitoring. Click Disable at the top of the table of Hosts.

Consequences

When monitoring on a host is disabled, all monitoring object in the hierarchy under that host are disabled. In the disabled state, monitored objects are no longer updated, although they may still contain the last value. Monitoring rules that depend on a disabled object are suspended. To enable a host that was disabled, follow this procedure using the Enable button at the top of the table of Hosts.

ProcedureTo Create a New Monitoring Rule

A monitoring rule, also called a monitoring job, is a set of conditions of monitored values that the user defines to trigger an alarm. The monitoring rule wizard in the Monitoring Console helps you define the conditions you would like to monitor.

  1. If necessary, navigate to the Deployment level display by clicking the “Deployment” link at the root of the hierarchy in the left-hand side of the Monitoring Console. Now select the Rules tab in the right-hand pane as shown in the following screen capture, and click New in the table of monitoring rules:

    The Monitoring Rules tab in the top-level Deployment contains a table of all rules and the controls to manage them.

  2. Give a name to your new monitoring rule and choose the type of server you wish to monitor.

    Step 1 of the Rule wizard: enter a name and choose a product component to monitor.

  3. Choose the instance of the component product you wish to monitor. In the case when there are two instances of the same product installed on separate hosts, some instances may have identical names in this table. In this case, the instances may be in the same order as they appear in the hierarchy in the left-hand pane, but there is no sure way to know. You may need to create identical monitoring rules on both instances to ensure you rule is defined.

    Step 2 of the Rule wizard: choose an application instance, similar names may be differentiated based on their order

  4. Select the object that contains the attribute you wish to monitor:

    Step 3 of the Rule Wizard: select the object to monitor.

  5. Now, you can finally specify the attribute that will be monitored along with the values that will generate an alarm.

    Step 4 of the Rule Wizard: define the threshold and offset values.

  6. Enter start and end dates for the rule. Unlike the schedule which determines the activity or inactivity of a rule, the start and end dates determine when a rule is defined to exist. When a start time is in the past, as always happens with the default value, the monitoring associated with this rule will begin immediately

    Step 5 of the Rule Wizard: define until when the new rule will remain defined.

  7. Optionally, use the controls to create one or more time ranges during which the rule will be actively monitoring You can also select the days of the week to create a weekly schedule.

    Step 6 of the Rule Wizard: define an optional daily and weekly schedule during which the job will be active.

  8. In this final step of the Rule Wizard, review your input and click Finish to create your new rule.

    Step 7 of the Rule Wizard: review your input and create the rule.

    When the Rule Wizard is finished, you should see the Monitoring Rules tab again, with your new rule in the table of rules.