Package com.unboundid.ldap.sdk.unboundidds.monitors

Class UnboundIDWorkQueueMonitorEntry

java.lang.Object
com.unboundid.ldap.sdk.unboundidds.monitors.MonitorEntry
com.unboundid.ldap.sdk.unboundidds.monitors.UnboundIDWorkQueueMonitorEntry
All Implemented Interfaces:
Serializable
@NotMutable @ThreadSafety(level=COMPLETELY_THREADSAFE) public final class UnboundIDWorkQueueMonitorEntry extends MonitorEntry
This class defines a monitor entry that provides information about the state of the UnboundID work queue. This has replaced the traditional work queue as the default work queue implementation used by the Directory 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.

The monitor information that it may make available includes:
  • The number of requests that were rejected because the work queue was already at its maximum capacity.
  • The number of operations currently held in the work queue waiting to be picked for processing by a worker thread.
  • The average number of operations held in the work queue since startup as observed from periodic polling.
  • The maximum number of operations held in the work queue at any time since startup as observed from periodic polling.
The server should present at most one UnboundID work queue monitor entry. It can be retrieved using the MonitorManager.getUnboundIDWorkQueueMonitorEntry(com.unboundid.ldap.sdk.LDAPConnection) method. This entry provides specific methods for accessing information about the state of the work queue (e.g., the getCurrentSize() method may be used to retrieve the number of operations currently held in the work queue). Alternately, this 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:

  • Constructor Details

    • UnboundIDWorkQueueMonitorEntry

      public UnboundIDWorkQueueMonitorEntry(@NotNull Entry entry)
      Creates a new UnboundID work queue monitor entry from the provided entry.
      Parameters:
      entry - The entry to be parsed as a traditional work queue monitor entry. It must not be null.

  • Method Details

    • getAverageSize

      @Nullable public Long getAverageSize()
      Retrieves the average number of operations observed in the work queue.
      Returns:
      The average number of operations observed in the work queue, or null if that information was not included in the monitor entry.

    • getRecentAverageSize

      @Nullable public Long getRecentAverageSize()
      Retrieves the average number of operations observed in the work queue over a recent interval.
      Returns:
      The average number of operations observed in the work queue over a recent interval, or null if that information was not included in the monitor entry.

    • getCurrentSize

      @Nullable public Long getCurrentSize()
      Retrieves the number of operations that are currently in the work queue waiting to be processed.
      Returns:
      The number of operations that are currently in the work queue waiting to be processed, or null if that information was not included in the monitor entry.

    • getMaxSize

      @Nullable public Long getMaxSize()
      Retrieves the maximum number of operations observed in the work queue at any given time.
      Returns:
      The total number of operations observed in the work queue at any given time, or null if that information was not included in the monitor entry.

    • getRequestsRejectedDueToQueueFull

      @Nullable public Long getRequestsRejectedDueToQueueFull()
      Retrieves the total number of operation requests that were rejected because the work queue was at its maximum capacity.
      Returns:
      The total number of operation requests rejected because the work queue was at its maximum capacity, or null if that information was not included in the monitor entry.

    • getRequestsStolen

      @Nullable public Long getRequestsStolen()
      Retrieves the total number of operation requests that have been stolen from their primary queue by a worker thread associated with a different queue.
      Returns:
      The total number of operation requests that have been stolen from their primary queue by a worker thread associated with a different queue, or null if that information was not included in the monitor entry.

    • getNumWorkerThreads

      @Nullable public Long getNumWorkerThreads()
      Retrieves the number of worker threads configured for the work queue.
      Returns:
      The number of worker threads configured for the work queue, or null if that information was not included in the monitor entry.

    • getNumBusyWorkerThreads

      @Nullable public Long getNumBusyWorkerThreads()
      Retrieves the number of worker threads that are currently busy processing an operation.
      Returns:
      The number of worker threads that are currently busy processing an operation, or null if that information was not included in the monitor entry.

    • getCurrentWorkerThreadPercentBusy

      @Nullable public Long getCurrentWorkerThreadPercentBusy()
      Retrieves the percentage of worker threads that are currently busy processing an operation.
      Returns:
      The percentage of worker threads that are currently busy processing an operation, or null if that information was not included in the monitor entry.

    • getAverageWorkerThreadPercentBusy

      @Nullable public Long getAverageWorkerThreadPercentBusy()
      Retrieves the average percentage of the time since startup that worker threads have spent busy processing operations.
      Returns:
      The average percentage of the time since startup that worker threads have spent busy processing operations, or null if that information was not included in the monitor entry.

    • getRecentWorkerThreadPercentBusy

      @Nullable public Long getRecentWorkerThreadPercentBusy()
      Retrieves the percentage of the time over a recent interval that worker threads have spent busy processing operations.
      Returns:
      The percentage of the time over a recent interval that worker threads have spent busy processing operations, or null if that information was not included in the monitor entry.

    • getMaxWorkerThreadPercentBusy

      @Nullable public Long getMaxWorkerThreadPercentBusy()
      Retrieves the maximum percentage of the time over any interval that worker threads have spent busy processing operations.
      Returns:
      The maximum percentage of the time over any interval that worker threads have spent busy processing operations, or null if that information was not included in the monitor entry.

    • getAverageOperationQueueTimeMillis

      @Nullable public Long getAverageOperationQueueTimeMillis()
      Retrieves the average length of time in milliseconds that operations have been required to wait on the work queue before being picked up by a worker thread.
      Returns:
      The average length of time in milliseconds that operations have been required to wait on the work queue, or null if that information was not included in the monitor entry.

    • getRecentOperationQueueTimeMillis

      @Nullable public Long getRecentOperationQueueTimeMillis()
      Retrieves the average length of time in milliseconds that recently-processed operations have been required to wait on the work queue before being picked up by a worker thread.
      Returns:
      The average length of time in milliseconds that recently-processed operations have been required to wait on the work queue, or null if that information was not included in the monitor entry.

    • getCurrentAdministrativeSessionQueueSize

      @Nullable public Long getCurrentAdministrativeSessionQueueSize()
      Retrieves the number of operations that are currently waiting to be processed in the portion of the work queue reserved for operations that are part of an administrative session.
      Returns:
      The number of operations that are currently waiting to be processed in the portion of the work queue reserved for operations that are part of an administrative session, or null if that information was not included in the monitor entry.

    • getMaxAdministrativeSessionQueueSize

      @Nullable public Long getMaxAdministrativeSessionQueueSize()
      Retrieves the maximum number of operations observed in the dedicated administrative session queue at any given time.
      Returns:
      The total number of operations observed in the dedicated administrative session queue at any given time, or null if that information was not included in the monitor entry.

    • getNumAdministrativeSessionWorkerThreads

      @Nullable public Long getNumAdministrativeSessionWorkerThreads()
      Retrieves the number of worker threads that have been reserved for processing operations that are part of an administrative session.
      Returns:
      The number of worker threads that have been reserved for processing operations that are part of an administrative session, or null if that information was not included in the monitor entry.

    • getNumBusyAdministrativeSessionWorkerThreads

      @Nullable public Long getNumBusyAdministrativeSessionWorkerThreads()
      Retrieves the number of worker threads that are currently busy processing an operation which is part of an administrative session.
      Returns:
      The number of worker threads that are currently busy processing an operation which is part of an administrative session, or null if that information was not included in the monitor entry.

    • getMonitorDisplayName

      @NotNull public 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

      @NotNull public 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

      @NotNull public Map<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.