W3cubDocs

Interface MonitorMBean

All Known Subinterfaces:: CounterMonitorMBean, GaugeMonitorMBean, StringMonitorMBean

All Known Implementing Classes:: CounterMonitor, GaugeMonitor, Monitor, StringMonitor

public interface MonitorMBean

Exposes the remote management interface of monitor MBeans.

Since:: 1.5

Method Summary

Modifier and Type	Method	Description
`void`	`addObservedObject(ObjectName object)`	Adds the specified object in the set of observed MBeans.
`boolean`	`containsObservedObject(ObjectName object)`	Tests whether the specified object is in the set of observed MBeans.
`long`	`getGranularityPeriod()`	Gets the granularity period (in milliseconds).
`String`	`getObservedAttribute()`	Gets the attribute being observed.
`ObjectName`	`getObservedObject()`	Deprecated. As of JMX 1.2, replaced by `getObservedObjects()`
`ObjectName[]`	`getObservedObjects()`	Returns an array containing the objects being observed.
`boolean`	`isActive()`	Tests if the monitor MBean is active.
`void`	`removeObservedObject(ObjectName object)`	Removes the specified object from the set of observed MBeans.
`void`	`setGranularityPeriod(long period)`	Sets the granularity period (in milliseconds).
`void`	`setObservedAttribute(String attribute)`	Sets the attribute to observe.
`void`	`setObservedObject(ObjectName object)`	Deprecated. As of JMX 1.2, replaced by `addObservedObject(javax.management.ObjectName)`
`void`	`start()`	Starts the monitor.
`void`	`stop()`	Stops the monitor.

Method Details

start

void start()

Starts the monitor.

stop

void stop()

Stops the monitor.

addObservedObject

void addObservedObject(ObjectName object) throws IllegalArgumentException

Adds the specified object in the set of observed MBeans.

Parameters:: object - The object to observe.
Throws:: IllegalArgumentException - the specified object is null.

removeObservedObject

void removeObservedObject(ObjectName object)

Removes the specified object from the set of observed MBeans.

Parameters:: object - The object to remove.

containsObservedObject

boolean containsObservedObject(ObjectName object)

Tests whether the specified object is in the set of observed MBeans.

Parameters:: object - The object to check.
Returns:: true if the specified object is in the set, false otherwise.

getObservedObjects

ObjectName[] getObservedObjects()

Returns an array containing the objects being observed.

Returns:: The objects being observed.

getObservedObject

@Deprecated ObjectName getObservedObject()

Deprecated.

As of JMX 1.2, replaced by getObservedObjects()

Gets the object name of the object being observed.

Returns:

The object being observed.

See Also:

setObservedObject

@Deprecated void setObservedObject(ObjectName object)

Deprecated.

As of JMX 1.2, replaced by addObservedObject(javax.management.ObjectName)

Sets the object to observe identified by its object name.

Parameters:

object - The object to observe.

See Also:

getObservedAttribute

String getObservedAttribute()

Gets the attribute being observed.

Returns:

The attribute being observed.

See Also:

setObservedAttribute

void setObservedAttribute(String attribute)

Sets the attribute to observe.

Parameters:

attribute - The attribute to observe.

See Also:

getGranularityPeriod

long getGranularityPeriod()

Gets the granularity period (in milliseconds).

Returns:

The granularity period.

See Also:

setGranularityPeriod

void setGranularityPeriod(long period) throws IllegalArgumentException

Sets the granularity period (in milliseconds).

Parameters:

period - The granularity period.

Throws:

IllegalArgumentException - The granularity period is less than or equal to zero.

See Also:

isActive

boolean isActive()

Tests if the monitor MBean is active. A monitor MBean is marked active when the start method is called. It becomes inactive when the stop method is called.

Returns:: true if the monitor MBean is active, false otherwise.

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.management/javax/management/monitor/MonitorMBean.html