Class LDAPExternalServerMonitorEntry

java.lang.Object
com.unboundid.ldap.sdk.unboundidds.monitors.MonitorEntry
com.unboundid.ldap.sdk.unboundidds.monitors.LDAPExternalServerMonitorEntry
All Implemented Interfaces:
Serializable

This class defines a monitor entry that provides general information about an LDAP external server 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 address, port, and security mechanism used to communicate with the server.
  • The DN of the configuration entry for the load-balancing algorithm that is using the LDAP external server object.
  • Information about the health of the LDAP external server.
  • The number of attempted, successful, and failed operations processed using the LDAP external server.
The server should present an LDAP external server monitor entry for each server used by each load-balancing algorithm. These entries can be retrieved using the MonitorManager.getLDAPExternalServerMonitorEntries(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:
  • Field Details

  • Constructor Details

    • LDAPExternalServerMonitorEntry

      Creates a new LDAP external server monitor entry from the provided entry.
      Parameters:
      entry - The entry to be parsed as an LDAP external server monitor entry. It must not be null.
  • Method Details

    • getServerAddress

      Retrieves the address of the LDAP external server.
      Returns:
      The address of the LDAP external server, or null if it was not included in the monitor entry.
    • getServerPort

      Retrieves the port of the LDAP external server.
      Returns:
      The port of the LDAP external server, or null if it was not included in the monitor entry.
    • getCommunicationSecurity

      Retrieves the communication security mechanism used when communicating with the external server.
      Returns:
      The communication security mechanism used when communicating with the external server, or null if it was not included in the monitor entry.
    • getLoadBalancingAlgorithmDN

      Retrieves the DN of the configuration entry for the load-balancing algorithm that uses the LDAP external server.
      Returns:
      The DN of the configuration entry for the load-balancing algorithm that uses the LDAP external server, or null if it was not included in the monitor entry.
    • getHealthCheckState

      Retrieves the health check state for the LDAP external server.
      Returns:
      The health check state for the LDAP external server, or null if it was not included in the monitor entry.
    • getHealthCheckScore

      Retrieves the health check score for the LDAP external server.
      Returns:
      The health check score for the LDAP external server, or null if it was not included in the monitor entry.
    • getHealthCheckMessages

      Retrieves the list of health check messages for the LDAP external server.
      Returns:
      The list of health check messages for the LDAP external server, or an empty list if it was not included in the monitor entry.
    • getHealthCheckUpdateTime

      Retrieves the time the health check information was last updated for the LDAP external server.
      Returns:
      The time the health check information was last updated for the LDAP external server, or null if it was not included in the monitor entry.
    • getAddAttempts

      Retrieves the total number of add operations attempted against the LDAP external server.
      Returns:
      The total number of add operations attempted against the LDAP external server, or null if it was not included in the monitor entry.
    • getAddFailures

      Retrieves the number of failed add attempts against the LDAP external server.
      Returns:
      The number of failed add attempts against the LDAP external server, or null if it was not included in the monitor entry.
    • getAddSuccesses

      Retrieves the number of successful add attempts against the LDAP external server.
      Returns:
      The number of successful add attempts against the LDAP external server, or null if it was not included in the monitor entry.
    • getBindAttempts

      Retrieves the total number of bind operations attempted against the LDAP external server.
      Returns:
      The total number of bind operations attempted against the LDAP external server, or null if it was not included in the monitor entry.
    • getBindFailures

      Retrieves the number of failed bind attempts against the LDAP external server.
      Returns:
      The number of failed bind attempts against the LDAP external server, or null if it was not included in the monitor entry.
    • getBindSuccesses

      Retrieves the number of successful bind attempts against the LDAP external server.
      Returns:
      The number of successful bind attempts against the LDAP external server, or null if it was not included in the monitor entry.
    • getCompareAttempts

      Retrieves the total number of compare operations attempted against the LDAP external server.
      Returns:
      The total number of compare operations attempted against the LDAP external server, or null if it was not included in the monitor entry.
    • getCompareFailures

      Retrieves the number of failed compare attempts against the LDAP external server.
      Returns:
      The number of failed compare attempts against the LDAP external server, or null if it was not included in the monitor entry.
    • getCompareSuccesses

      Retrieves the number of successful compare attempts against the LDAP external server.
      Returns:
      The number of successful compare attempts against the LDAP external server, or null if it was not included in the monitor entry.
    • getDeleteAttempts

      Retrieves the total number of delete operations attempted against the LDAP external server.
      Returns:
      The total number of delete operations attempted against the LDAP external server, or null if it was not included in the monitor entry.
    • getDeleteFailures

      Retrieves the number of failed delete attempts against the LDAP external server.
      Returns:
      The number of failed delete attempts against the LDAP external server, or null if it was not included in the monitor entry.
    • getDeleteSuccesses

      Retrieves the number of successful delete attempts against the LDAP external server.
      Returns:
      The number of successful delete attempts against the LDAP external server, or null if it was not included in the monitor entry.
    • getModifyAttempts

      Retrieves the total number of modify operations attempted against the LDAP external server.
      Returns:
      The total number of modify operations attempted against the LDAP external server, or null if it was not included in the monitor entry.
    • getModifyFailures

      Retrieves the number of failed modify attempts against the LDAP external server.
      Returns:
      The number of failed modify attempts against the LDAP external server, or null if it was not included in the monitor entry.
    • getModifySuccesses

      Retrieves the number of successful modify attempts against the LDAP external server.
      Returns:
      The number of successful modify attempts against the LDAP external server, or null if it was not included in the monitor entry.
    • getModifyDNAttempts

      Retrieves the total number of modify DN operations attempted against the LDAP external server.
      Returns:
      The total number of modify DN operations attempted against the LDAP external server, or null if it was not included in the monitor entry.
    • getModifyDNFailures

      Retrieves the number of failed modify DN attempts against the LDAP external server.
      Returns:
      The number of failed modify DN attempts against the LDAP external server, or null if it was not included in the monitor entry.
    • getModifyDNSuccesses

      Retrieves the number of successful modify DN attempts against the LDAP external server.
      Returns:
      The number of successful modify DN attempts against the LDAP external server, or null if it was not included in the monitor entry.
    • getSearchAttempts

      Retrieves the total number of search operations attempted against the LDAP external server.
      Returns:
      The total number of search operations attempted against the LDAP external server, or null if it was not included in the monitor entry.
    • getSearchFailures

      Retrieves the number of failed search attempts against the LDAP external server.
      Returns:
      The number of failed search attempts against the LDAP external server, or null if it was not included in the monitor entry.
    • getSearchSuccesses

      Retrieves the number of successful search attempts against the LDAP external server.
      Returns:
      The number of successful search attempts against the LDAP external server, or null if it was not included in the monitor entry.
    • getCommonPoolAvailableConnections

      Retrieves the number of currently available connections in the common connection pool used by the LDAP external server used for both bind and non-bind operations.
      Returns:
      The number of currently available connections in the common connection pool used by the LDAP external server used for both bind and non-bind operations, or null if it was not included in the monitor entry or if the external server uses separate pools for bind and non-bind operations.
    • getCommonPoolMaxAvailableConnections

      Retrieves the maximum number of connections that may be available in the common connection pool used by the LDAP external server for both bind and non-bind operations.
      Returns:
      The maximum number of connections that may be available in the common connection pool used by the LDAP external server for both bind and non-bind operations, or null if it was not included in the monitor entry or if the external server uses separate pools for bind and non-bind operations.
    • getCommonPoolNumSuccessfulConnectionAttempts

      Retrieves the number of successful connection attempts in the common connection pool used by the LDAP external server for both bind and non-bind operations.
      Returns:
      The number of successful connection attempts in the common connection pool used by the LDAP external server for both bind and non-bind operations, or null if it was not included in the monitor entry or if the external server uses separate pools for bind and non-bind operations.
    • getCommonPoolNumFailedConnectionAttempts

      Retrieves the number of failed connection attempts in the common connection pool used by the LDAP external server for both bind and non-bind operations.
      Returns:
      The number of failed connection attempts in the common connection pool used by the LDAP external server for both bind and non-bind operations, or null if it was not included in the monitor entry or if the external server uses separate pools for bind and non-bind operations.
    • getCommonPoolNumClosedDefunct

      Retrieves the number of connections in the common connection pool used by the LDAP external server for both bind and non-bind operations that have been closed as defunct.
      Returns:
      The number of connections in the common connection pool used by the LDAP external server for both bind and non-bind operations that have been closed as defunct, or null if it was not included in the monitor entry or if the external server uses separate pools for bind and non-bind operations.
    • getCommonPoolNumClosedExpired

      Retrieves the number of connections in the common connection pool used by the LDAP external server for processing both bind and non-bind operations that have been closed as expired.
      Returns:
      The number of connections in the common connection pool used by the LDAP external server for both bind and non-bind operations that have been closed as expired, or null if it was not included in the monitor entry or if the external server uses separate pools for bind and non-bind operations.
    • getCommonPoolNumClosedUnneeded

      Retrieves the number of connections in the common connection pool used by the LDAP external server for both bind and non-bind operations that have been closed as unneeded.
      Returns:
      The number of connections in the common connection pool used by the LDAP external server for both bind and non-bind operations that have been closed as unneeded, or null if it was not included in the monitor entry or if the external server uses separate pools for bind and non-bind operations.
    • getCommonPoolTotalSuccessfulCheckouts

      Retrieves the total number of successful checkouts from the common connection pool used by the LDAP external server for both bind and non-bind operations.
      Returns:
      The total number of successful checkouts from the common connection pool used by the LDAP external server for both bind and non-bind operations, or null if it was not included in the monitor entry or if the external server uses separate pools for bind and non-bind operations.
    • getCommonPoolNumSuccessfulCheckoutsWithoutWaiting

      Retrieves the number of successful checkouts from the common connection pool used by the LDAP external server for both bind and non-bind operations in which an existing connection was retrieved without needing to wait.
      Returns:
      The number of successful checkouts from the common connection pool used by the LDAP external server for both bind and non-bind operations in which an existing connection was retrieved without needing to wait, or null if it was not included in the monitor entry or if the external server uses separate pools for bind and non-bind operations.
    • getCommonPoolNumSuccessfulCheckoutsAfterWaiting

      Retrieves the number of successful checkouts from the common connection pool used by the LDAP external server for both bind and non-bind operations in which an existing connection was retrieved after waiting for the connection to become available.
      Returns:
      The number of successful checkouts from the common connection pool used by the LDAP external server for both bind and non-bind operations in which an existing connection was retrieved after waiting for the connection to become available, or null if it was not included in the monitor entry or if the external server uses separate pools for bind and non-bind operations.
    • getCommonPoolNumSuccessfulCheckoutsNewConnection

      Retrieves the number of successful checkouts from the common connection pool used by the LDAP external server for both bind and non-bind operations in which an existing connection was retrieved after creating a new connection.
      Returns:
      The number of successful checkouts from the common connection pool used by the LDAP external server for both bind and non-bind operations in which an existing connection was retrieved after creating a new connection, or null if it was not included in the monitor entry or if the external server uses separate pools for bind and non-bind operations.
    • getCommonPoolNumFailedCheckouts

      Retrieves the number of failed checkout attempts from the common connection pool used by the LDAP external server for both bind and non-bind operations.
      Returns:
      The number of failed checkout attempts from the common connection pool used by the LDAP external server for both bind and non-bind operations, or null if it was not included in the monitor entry or if the external server uses separate pools for bind and non-bind operations.
    • getCommonPoolNumReleasedValid

      Retrieves the number of connections released as valid back to the common connection pool used by the LDAP external server for bind and non-bind operations.
      Returns:
      The number of connections released as valid back to the common connection pool used by the LDAP external server used for bind and non-bind operations, or null if it was not included in the monitor entry or if the external server uses a separate pools for bind and non-bind operations.
    • getBindPoolAvailableConnections

      Retrieves the number of currently available connections in the bind connection pool used by the LDAP external server.
      Returns:
      The number of currently available connections in the bind connection pool used by the LDAP external server, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getBindPoolMaxAvailableConnections

      Retrieves the maximum number of connections that may be available in the bind connection pool used by the LDAP external server.
      Returns:
      The maximum number of connections that may be available in the bind connection pool used by the LDAP external server, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getBindPoolNumSuccessfulConnectionAttempts

      Retrieves the number of successful connection attempts in the bind connection pool used by the LDAP external server.
      Returns:
      The number of successful connection attempts in the bind connection pool used by the LDAP external server, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getBindPoolNumFailedConnectionAttempts

      Retrieves the number of failed connection attempts in the bind connection pool used by the LDAP external server.
      Returns:
      The number of failed connection attempts in the bind connection pool used by the LDAP external server, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getBindPoolNumClosedDefunct

      Retrieves the number of connections in the bind connection pool used by the LDAP external server that have been closed as defunct.
      Returns:
      The number of connections in the bind connection pool used by the LDAP external server that have been closed as defunct, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getBindPoolNumClosedExpired

      Retrieves the number of connections in the bind connection pool used by the LDAP external server that have been closed as expired.
      Returns:
      The number of connections in the bind connection pool used by the LDAP external server that have been closed as expired, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getBindPoolNumClosedUnneeded

      Retrieves the number of connections in the bind connection pool used by the LDAP external server that have been closed as unneeded.
      Returns:
      The number of connections in the bind connection pool used by the LDAP external server that have been closed as unneeded, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getBindPoolTotalSuccessfulCheckouts

      Retrieves the total number of successful checkouts from the bind connection pool used by the LDAP external server.
      Returns:
      The total number of successful checkouts from the bind connection pool used by the LDAP external server, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getBindPoolNumSuccessfulCheckoutsWithoutWaiting

      Retrieves the number of successful checkouts from the bind connection pool used by the LDAP external server in which an existing connection was retrieved without needing to wait.
      Returns:
      The number of successful checkouts from the bind connection pool used by the LDAP external server in which an existing connection was retrieved without needing to wait, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getBindPoolNumSuccessfulCheckoutsAfterWaiting

      Retrieves the number of successful checkouts from the bind connection pool used by the LDAP external server in which an existing connection was retrieved after waiting for the connection to become available.
      Returns:
      The number of successful checkouts from the bind connection pool used by the LDAP external server in which an existing connection was retrieved after waiting for the connection to become available, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getBindPoolNumSuccessfulCheckoutsNewConnection

      Retrieves the number of successful checkouts from the bind connection pool used by the LDAP external server in which an existing connection was retrieved after creating a new connection.
      Returns:
      The number of successful checkouts from the bind connection pool used by the LDAP external server in which an existing connection was retrieved after creating a new connection, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getBindPoolNumFailedCheckouts

      Retrieves the number of failed checkout attempts from the bind connection pool used by the LDAP external server.
      Returns:
      The number of failed checkout attempts from the bind connection pool used by the LDAP external server, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getBindPoolNumReleasedValid

      Retrieves the number of connections released as valid back to the bind connection pool used by the LDAP external server.
      Returns:
      The number of connections released as valid back to the bind connection pool used by the LDAP external server, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getNonBindPoolAvailableConnections

      Retrieves the number of currently available connections in the non-bind connection pool used by the LDAP external server.
      Returns:
      The number of currently available connections in the non-bind connection pool used by the LDAP external server, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getNonBindPoolMaxAvailableConnections

      Retrieves the maximum number of connections that may be available in the non-bind connection pool used by the LDAP external server.
      Returns:
      The maximum number of connections that may be available in the non-bind connection pool used by the LDAP external server, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getNonBindPoolNumSuccessfulConnectionAttempts

      Retrieves the number of successful connection attempts in the non-bind connection pool used by the LDAP external server.
      Returns:
      The number of successful connection attempts in the non-bind connection pool used by the LDAP external server, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getNonBindPoolNumFailedConnectionAttempts

      Retrieves the number of failed connection attempts in the non-bind connection pool used by the LDAP external server.
      Returns:
      The number of failed connection attempts in the non-bind connection pool used by the LDAP external server, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getNonBindPoolNumClosedDefunct

      Retrieves the number of connections in the non-bind connection pool used by the LDAP external server that have been closed as defunct.
      Returns:
      The number of connections in the non-bind connection pool used by the LDAP external server that have been closed as defunct, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getNonBindPoolNumClosedExpired

      Retrieves the number of connections in the non-bind connection pool used by the LDAP external server that have been closed as expired.
      Returns:
      The number of connections in the non-bind connection pool used by the LDAP external server that have been closed as expired, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getNonBindPoolNumClosedUnneeded

      Retrieves the number of connections in the non-bind connection pool used by the LDAP external server that have been closed as unneeded.
      Returns:
      The number of connections in the non-bind connection pool used by the LDAP external server that have been closed as unneeded, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getNonBindPoolTotalSuccessfulCheckouts

      Retrieves the total number of successful checkouts from the non-bind connection pool used by the LDAP external server.
      Returns:
      The total number of successful checkouts from the non-bind connection pool used by the LDAP external server, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getNonBindPoolNumSuccessfulCheckoutsWithoutWaiting

      Retrieves the number of successful checkouts from the non-bind connection pool used by the LDAP external server in which an existing connection was retrieved without needing to wait.
      Returns:
      The number of successful checkouts from the non-bind connection pool used by the LDAP external server in which an existing connection was retrieved without needing to wait, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getNonBindPoolNumSuccessfulCheckoutsAfterWaiting

      Retrieves the number of successful checkouts from the non-bind connection pool used by the LDAP external server in which an existing connection was retrieved after waiting for the connection to become available.
      Returns:
      The number of successful checkouts from the non-bind connection pool used by the LDAP external server in which an existing connection was retrieved after waiting for the connection to become available, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getNonBindPoolNumSuccessfulCheckoutsNewConnection

      Retrieves the number of successful checkouts from the non-bind connection pool used by the LDAP external server in which an existing connection was retrieved after creating a new connection.
      Returns:
      The number of successful checkouts from the non-bind connection pool used by the LDAP external server in which an existing connection was retrieved after creating a new connection, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getNonBindPoolNumFailedCheckouts

      Retrieves the number of failed checkout attempts from the non-bind connection pool used by the LDAP external server.
      Returns:
      The number of failed checkout attempts from the non-bind connection pool used by the LDAP external server, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • getNonBindPoolNumReleasedValid

      Retrieves the number of connections released as valid back to the non-bind connection pool used by the LDAP external server.
      Returns:
      The number of connections released as valid back to the non-bind connection pool used by the LDAP external server, or null if it was not included in the monitor entry or if the external server uses a common pool for bind and non-bind operations.
    • 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

      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

      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.