com.unboundid.ldap.sdk.unboundidds.monitors
Class LoadBalancingAlgorithmMonitorEntry

java.lang.Object
  com.unboundid.ldap.sdk.unboundidds.monitors.MonitorEntry
      com.unboundid.ldap.sdk.unboundidds.monitors.LoadBalancingAlgorithmMonitorEntry

All Implemented Interfaces:

java.io.Serializable

@NotMutable
@ThreadSafety(level=COMPLETELY_THREADSAFE)
public final class LoadBalancingAlgorithmMonitorEntry
extends MonitorEntry

NOTE: This class is part of the Commercial Edition of the UnboundID LDAP SDK for Java. It is not available for use in applications that include only the Standard Edition of the LDAP SDK, and is not supported for use in conjunction with non-UnboundID products.

This class defines a monitor entry that provides information about a load-balancing algorithm used by the UnboundID Directory Proxy Server. Information that it may make available includes:

• The aggregate health check state for servers associated with the load-balancing algorithm.
• Information about each server associated with the load-balancing algorithm, including the address, port, and health check state for the server.
• The number of available, degraded, and unavailable servers associated with the load-balancing algorithm.

The server should present a load-balancing algorithm monitor entry for each load-balancing algorithm used by a proxying request processor. These entries can be retrieved using the MonitorManager.getLoadBalancingAlgorithmMonitorEntries(com.unboundid.ldap.sdk.LDAPConnection) method. These entries provide specific methods for accessing this information. Alternately, the information may be accessed using the generic API. See the MonitorManager class documentation for an example that demonstrates the use of the generic API for accessing monitor data.

See Also:

Serialized Form

Field Summary

protected static java.lang.String

LOAD_BALANCING_ALGORITHM_MONITOR_OC The structural object class used in LDAP external server monitor entries.

Constructor Summary

LoadBalancingAlgorithmMonitorEntry(Entry entry)
Creates a new load-balancing algorithm monitor entry from the provided entry.

Method Summary

java.lang.String	getAlgorithmName() Retrieves the name of the load-balancing algorithm.
java.lang.String	getConfigEntryDN() Retrieves the DN of the configuration entry for the load-balancing algorithm.
HealthCheckState	getHealthCheckState() Retrieves the aggregate health check state for the load-balancing algorithm.
HealthCheckState	getLocalServersHealthCheckState() Retrieves the aggregate health check state for local servers for the load-balancing algorithm.
java.util.Map<java.lang.String,MonitorAttribute>	getMonitorAttributes() Retrieves the set of parsed monitor attributes for this monitor entry, mapped from a unique identifier (in all lowercase characters) to the corresponding monitor attribute.
java.lang.String	getMonitorDescription() Retrieves a human-readable description name for this monitor entry.
java.lang.String	getMonitorDisplayName() Retrieves a human-readable display name for this monitor entry.
HealthCheckState	getNonLocalServersHealthCheckState() Retrieves the aggregate health check state for non-local servers for the load-balancing algorithm.
java.lang.Long	getNumAvailableServers() Retrieves the number of servers associated with the load-balancing algorithm that have a health check state of AVAILABLE.
java.lang.Long	getNumDegradedServers() Retrieves the number of servers associated with the load-balancing algorithm that have a health check state of DEGRADED.
java.lang.Long	getNumUnavailableServers() Retrieves the number of servers associated with the load-balancing algorithm that have a health check state of UNAVAILABLE.
java.util.List<LoadBalancingAlgorithmServerAvailabilityData>	getServerAvailabilityData() Retrieves a list with information about the healths of the individual LDAP external servers associated with the load-balancing algorithm.

Methods inherited from class com.unboundid.ldap.sdk.unboundidds.monitors.MonitorEntry

addMonitorAttribute, addMonitorAttribute, addMonitorAttribute, addMonitorAttribute, addMonitorAttribute, addMonitorAttribute, addMonitorAttribute, decode, getBoolean, getDate, getDN, getDouble, getEntry, getInteger, getLong, getMonitorClass, getMonitorName, getString, getStrings, toString, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

LOAD_BALANCING_ALGORITHM_MONITOR_OC

protected static final java.lang.String LOAD_BALANCING_ALGORITHM_MONITOR_OC

The structural object class used in LDAP external server monitor entries.

See Also:

Constant Field Values

Constructor Detail

LoadBalancingAlgorithmMonitorEntry

public LoadBalancingAlgorithmMonitorEntry(Entry entry)

Creates a new load-balancing algorithm monitor entry from the provided entry.

Parameters:

entry - The entry to be parsed as a load-balancing algorithm monitor entry. It must not be null.

Method Detail

getAlgorithmName

public java.lang.String getAlgorithmName()

Retrieves the name of the load-balancing algorithm.

Returns:

The name of the load-balancing algorithm, or null if it was not included in the monitor entry.

getConfigEntryDN

public java.lang.String getConfigEntryDN()

Retrieves the DN of the configuration entry for the load-balancing algorithm.

Returns:

The DN of the configuration entry for the load-balancing algorithm, or null if it was not included in the monitor entry.

getHealthCheckState

public HealthCheckState getHealthCheckState()

Retrieves the aggregate health check state for the load-balancing algorithm.

Returns:

The aggregate health check state for the load-balancing algorithm, or null if it was not included in the monitor entry.

getLocalServersHealthCheckState

public HealthCheckState getLocalServersHealthCheckState()

Retrieves the aggregate health check state for local servers for the load-balancing algorithm.

Returns:

The aggregate health check state for local servers for the load-balancing algorithm, or null if it was not included in the monitor entry.

getNonLocalServersHealthCheckState

public HealthCheckState getNonLocalServersHealthCheckState()

Retrieves the aggregate health check state for non-local servers for the load-balancing algorithm.

Returns:

The aggregate health check state for non-local servers for the load-balancing algorithm, or null if it was not included in the monitor entry.

getServerAvailabilityData

public java.util.List<LoadBalancingAlgorithmServerAvailabilityData> getServerAvailabilityData()

Retrieves a list with information about the healths of the individual LDAP external servers associated with the load-balancing algorithm.

Returns:

A list with information about the healths of the individual LDAP external servers associated with the load-balancing algorithm, or an empty list if it was not included in the monitor entry.

getNumAvailableServers

public java.lang.Long getNumAvailableServers()

Retrieves the number of servers associated with the load-balancing algorithm that have a health check state of AVAILABLE.

Returns:

The number of servers associated with the load-balancing algorithm that have a health check state of AVAILABLE, or null if it was not included in the monitor entry.

getNumDegradedServers

public java.lang.Long getNumDegradedServers()

Retrieves the number of servers associated with the load-balancing algorithm that have a health check state of DEGRADED.

Returns:

The number of servers associated with the load-balancing algorithm that have a health check state of DEGRADED, or null if it was not included in the monitor entry.

getNumUnavailableServers

public java.lang.Long getNumUnavailableServers()

Retrieves the number of servers associated with the load-balancing algorithm that have a health check state of UNAVAILABLE.

Returns:

The number of servers associated with the load-balancing algorithm that have a health check state of UNAVAILABLE, or null if it was not included in the monitor entry.

getMonitorDisplayName

public java.lang.String getMonitorDisplayName()

Retrieves a human-readable display name for this monitor entry.

Overrides:

getMonitorDisplayName in class MonitorEntry

Returns:

A human-readable display name for this monitor entry.

getMonitorDescription

public java.lang.String getMonitorDescription()

Retrieves a human-readable description name for this monitor entry.

Overrides:

getMonitorDescription in class MonitorEntry

Returns:

A human-readable description name for this monitor entry.

getMonitorAttributes

public java.util.Map<java.lang.String,MonitorAttribute> getMonitorAttributes()

Retrieves the set of parsed monitor attributes for this monitor entry, mapped from a unique identifier (in all lowercase characters) to the corresponding monitor attribute.

Overrides:

getMonitorAttributes in class MonitorEntry

Returns:

The set of parsed monitor attributes for this monitor entry.