Foglight for JMX 5.9.8


	CAUTION: When you switch the MBean server model used by an agent, the selected agent's MBean server object is replaced with a new instance. The original MBean server object contains only historical data and is not updated.

To switch a server model:

On the Application Servers Administration dashboard, in the Monitoring Agents table, click the name of the agent whose server model you want to switch.

In the list that opens, click Switch server model.

In the Switch Server Model dialog box, select the server model that you want the agent to use.


	TIP: If the list is long, use the Search box to search for a model name or description.

Optional — If you require a new Server Model, click Create Server Model. For more information, see Creating MBean Server Models.

Click Next.

Read the warning message.

To continue with the change, click Finish.

Otherwise, click Previous to go back and select a different model, or click Cancel to close the dialog box without saving the change.

Define Server Model Instance Overrides for a JMX Agent

When a JMX agent is assigned to an MBean Server Model, the model defines which instances to collect by default. If you want more control over the instances collected by a specific agent, you can define agent instance overrides. For example, if an MBean type in the server model is left with instances as “unspecified”, you can define an override to collect all instances instead. Or, if the MBean Server Model is set to “All”, you may want to override the instances to be more selective.

To define an instance override for an agent:

On the Application Servers Administration dashboard, in the Monitoring Agents table, click the name of the agent whose server model instance you want to override.

In the list that opens, click Agent overrides.

The Monitored Instance Overrides: AgentName view opens in the display area. Use this view to specify the MBean instances you want to monitor for an agent. If left unspecified, the server model is used to determine which instances to monitor.

Click the name of an available MBean type.

In the Monitored Instance Overrides dialog box that opens, define MBean instance overrides for the selected agent.

Select the Apply the following overrides to ‘typename’ check box and do one of the following:

•

To disable collection for the selected MBean type, select Do not monitor.

•

To monitor all instances that are available for the MBean type, select Monitor all available instances.

•

To specify which instances to monitor, select Monitor some available instances as follows, and then select one of the following options:

•

Click Select Instances to open a list of discovered instances. From this list, you can explicitly include or exclude instances to monitor. Click Refresh to update the list. When finished, click Apply, then OK.


	NOTE: The agent must be connected to the MBean server in order to check for available instances.

•

Click Add Object Name Query to include or exclude instances that match the results of an object name query. On the Match Instances dialog box, type a query for the object name in the box, then click Set. Matching instances are included by default. To exclude them, clear the Include check box.

•

Click Add Regular Expression to include or exclude instances that match regular expression text. On the Match Instances dialog box, type the regular expression text in the box, then click Set. Instances with matching text are included by default. To exclude them, clear the Include check box.

Clear the Include default check box if you do not want to include the default monitored instances defined by the server model (for example, “all available”). This option is enabled by default (that is, the default monitored instances are automatically included).

Optional — click Preview Instances to see a list of MBeans you have selected to monitor. Click Refresh in the Monitored Instance Preview dialog box to update the list. This option allows you to quickly review your changes before you save them. When you are finished with the preview, click Close.


	NOTE: The agent must be connected to the MBean server in order to check for available instances.

Click OK.

The view updates to reflect the overrides you created.

If you are finished specifying overrides, use the breadcrumb trail at the top of the view to return to the Application Servers Administration dashboard.

Change a JMX Agent's Server Group

Change a JMX Agent’s Server Group

A server group is typically used to represent the domain, cluster, or any other logical or administrative grouping, to which an MBean server belongs. You can change the server group for a particular agent.

To change an agent’s server group:

On the Application Servers Administration dashboard, in the Monitoring Agents table, click the name of the agent whose server group you want to change.

In the list that opens, click Change assigned server group.

In the Change Server Group Assignment dialog box that opens, select one of the following options:

•

To use the server group that is defined by the server model, select Use the default.

•

To use an existing group, click Assign the following Server Group, and select the group from the list.

•

To define a new group, click Assign the following Server Group, and select Define new group from the list. Type a name for the new group in the Name box.

Click Change.