PingDirectory Server exposes its monitoring information under the cn=monitor entry. Various tools can be used to surface the server’s information including the PingDataMetrics Server, the Administrative Console, JConsole, LDAP command-line tools, or SNMP. The following information is collected for PingDirectory Server. To configure the PingData PingDataMetrics Server to display PingDirectory Server data, see the Ping Identity PingDataMetrics Server Administration Guide.
PingDirectory Server monitoring component
Component Description
Active Operations Provides information about the operations currently being processed by the server including the number of operations, information about the operation, and the number of active persistent searches.
Backend Provides general information about the state of the server backend, including the backend ID, base DN(s), entry counts, entry count for the cn=admin data, writability mode, and whether it is a private backend. The following backend monitors are provided:
  • adminRoot
  • ads-truststore
  • alerts
  • backup
  • config
  • monitor
  • schema
  • tasks
  • userRoot
Berkeley DB JE Environment Provides information about the state of the Oracle Berkeley DB Java Edition database used by the PingDirectory Server backend.
Client Connections Provides information about all client connections to the server.
Disk Space Usage Provides information about the disk space available to various components of the server. The disk space usage monitor evaluates the free space at locations registered through the DiskSpaceConsumer interface. Disk space monitoring excludes disk locations that do not have server components registered. However, other disk locations may still impact server performance, such as the operating system disk, if it becomes full. When relevant to the server, these locations include the server root, the location of the config directory, the location of every log file, all JE backend directories, the location of the changelog, the location of the replication environment database, and the location of any server extension that registers itself with the DiskSpaceConsumer interface.
Connection Handler Provides information about the available connection handlers on the server, which include the LDAP and LDIF connection handlers. These handlers are used to accept client connections.
General Provides general information about the server, including product name and server version.
JVM Stack Trace Provides a stack trace of all threads processing within the JVM.
LDAP Connection Handler Statistics Provides statistics about the interaction that the associated LDAP connection handler has had with its clients, including the number of connections established and closed, bytes read and written, LDAP messages, and operations handled.
Processing Time Histogram Categorizes operation processing times into a number of user-defined buckets of information, including the total number of operations processed, overall average response time, and number of processing times between 0ms and 1ms.
System Information Provides general information about the system and the JVM on which the server is running, including host name, operating system, JVM architecture, Java home, and Java version.
Version Provides information about the product version, including build ID and revision number.
Work Queue Provides information about the state of the PingDirectory Server work queue, which holds requests until they can be processed by a worker thread. The work queue configuration has a monitor-queue-time property set to true by default. This logs messages for new operations with a qtimeattribute included in the log messages. Its value is expressed in milliseconds and represents the length of time that operations are held in the work queue.

A dedicated thread pool can be used for processing administrative operations. This thread pool enables diagnosis and corrective action if all other worker threads are processing operations. To request that operations be processed using the administrative thread pool, the requester must have the use-admin-sessionprivilege (included for root users). By default, eight threads are available for this purpose. This can be changed with the num-administrative-session-worker-threads property in the work queue configuration.