Class LoadBalancingAlgorithmMonitorEntry

  • All Implemented Interfaces:
    java.io.Serializable

    @NotMutable
    @ThreadSafety(level=COMPLETELY_THREADSAFE)
    public final class LoadBalancingAlgorithmMonitorEntry
    extends MonitorEntry
    This class defines a monitor entry that provides information about a load-balancing algorithm used by the Directory Proxy Server.
    NOTE: This class, and other classes within the com.unboundid.ldap.sdk.unboundidds package structure, are only supported for use against Ping Identity, UnboundID, and Nokia/Alcatel-Lucent 8661 server products. These classes provide support for proprietary functionality or for external specifications that are not considered stable or mature enough to be guaranteed to work in an interoperable way with other types of LDAP servers.

    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
    • Constructor Detail

      • LoadBalancingAlgorithmMonitorEntry

        public LoadBalancingAlgorithmMonitorEntry​(@NotNull
                                                  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

        @Nullable
        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

        @Nullable
        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

        @Nullable
        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

        @Nullable
        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

        @Nullable
        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

        @NotNull
        public java.util.List<LoadBalancingAlgorithmServerAvailabilityDatagetServerAvailabilityData()
        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

        @Nullable
        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

        @Nullable
        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

        @Nullable
        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.
      • getMonitorAttributes

        @NotNull
        public java.util.Map<java.lang.String,​MonitorAttributegetMonitorAttributes()
        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.