Using the cn=monitor command
To view properties of a server, use the cn=monitor command.
idsldapsearch -h <servername> -p <portnumber> -b cn=monitor -s base objectclass=*
The following information displays:
- cn=monitor
- version=IBM Security Directory (SSL), Version 6.4
- directoryversion
- The specific version number that indicates the fixpack level.
- totalconnections
- The total number of connections since the server was started.
- total_ssl_connections
- The total number of SSL connections since the server was started.
- total_tls_connections
- The total number of TLS connections since the server was started.
- currentconnections
- The number of active connections.
- maxconnections
- The maximum number of active connections allowed.
- writewaiters
- The number of threads that are sending data back to the client.
- readwaiters
- The number of threads that are reading data from the client.
- opsinitiated
- The number of requests since the server was started.
- livethreads
- The number of worker threads that are used by the server.
- opscompleted
- The number of completed requests since the server was started.
- entriessent
- The number of entries that are sent by the server since the server was started.
- searchesrequested
- The number of requested searches since the server was started.
- searchescompleted
- The number of completed searches since the server was started.
- bindsrequested
- The number of bind operations that are requested since the server was started.
- bindscompleted
- The number of bind operations that are completed since the server was started.
- unbindsrequested
- The number of unbind operations that are requested since the server was started.
- unbindscompleted
- The number of unbind operations that are completed since the server was started.
- addsrequested
- The number of add operations that are requested since the server was started.
- addscompleted
- The number of add operations that are completed since the server was started.
- addsfromsuppliers
- The number of update operations that are received from replication supplier.
- deletesrequested
- The number of delete operations that are requested since the server was started.
- deletescompleted
- The number of delete operations that are completed since the server was started.
- deletesfromsuppliers
- The number of delete operations that are received from replication supplier.
- modrdnsrequested
- The number of modify RDN operations that are requested since the server was started.
- modrdnscompleted
- The number of modify RDN operations that are completed since the server was started.
- modrdnsfromsuppliers
- The number of modify RDN operations that are received from replication supplier.
- modifiesrequested
- The number of modify operations that are requested since the server was started.
- modifiescompleted
- The number of modify operations that are completed since the server was started.
- modifiesfromsuppliers
- The number of modify operations that are received from replication supplier.
- comparesrequested
- The number of compare operations that are requested since the server was started.
- comparescompleted
- The number of compare operations that are completed since the server was started.
- abandonsrequested
- The number of abandon operations that are requested since the server was started.
- abandonscompleted
- The number of abandon operations that are completed since the server was started.
- extopsrequested
- The number of extended operations that are requested since the server was started.
- extopscompleted
- The number of extended operations that are completed since the server was started.
- unknownopsrequested
- The number of unknown operations that are requested since the server was started.
- unknownopscompleted
- The number of unknown operations that are completed since the server was started.
- transactionsrequested
- The number of transaction requests initiated.
- transactionscompleted
- The number of transaction operations completed.
- transactionpreparesrequested
- The number of prepare transaction operations that are requested.
- transactionpreparescompleted
- The number of prepare transaction operations that are completed.
- transactioncommitsrequested
- The number of commit transaction operations requested.
- transactionscommitted
- The number of transaction operations committed.
- transactionrollbacksrequested
- The number of transaction operations that are requested for rollback.
- transactionsrolledback
- The number of transaction operations that are rolled back.
- transactionspreparedwaitingoncommit
- The number of transaction operations, which are prepared and waiting for commit/rollback.
- slapderrorlog_messages
- The number of server error messages that are recorded since the server was started or since a reset was performed.
- slapdclierrors_messages
- The number of DB2® error messages that are recorded since the server was started or since a reset was performed.
- auditlog_messages
- The number of audit messages that are recorded since the server was started or since a reset was performed.
- auditlog_failedop_messages
- The number of failed operation messages that are recorded since the server was started or since a reset was performed.
- filter_cache_size
- The maximum number of filters that are allowed in the cache.
- filter_cache_current
- The number of filters currently in the cache.
- filter_cache_hit
- The number of filters that are found in the cache.
- filter_cache_miss
- The number of search operations that attempted to use the filter cache, but did not find a matching operation in the cache.
- filter_cache_bypass_limit
- Search filters that return more entries than this limit are not cached.
- entry_cache_size
- The maximum number of entries that are allowed in the cache.
- entry_cache_current
- The number of entries currently in the cache.
- entry_cache_hit
- The number of entries that are found in the cache.
- entry_cache_miss
- The number of entries that are not found in the cache.
- group_members_cache_size
- The maximum number of groups whose members needs to be cached.
- group_members_cache_current
- The number of groups whose members are currently cached.
- group_members_cache_hit
- The number of groups whose members were requested and retrieved from the group members’ cache.
- group_members_cache_miss
- The number of groups whose members were requested and found in the group members’ cache that needed to have the members that are retrieved from DB2.
- group_members_cache_bypass
- The maximum number of members that are allowed in a group that is cached in the group members’ cache.
- acl_cache
- A Boolean value that indicates the ACL cache is active (TRUE) or inactive (FALSE).
- acl_cache_size
- The maximum number of entries in the ACL cache.
- operations_waiting
- The number of operations that are waiting in the deadlock detector.
- maximum_operations_waiting
- The maximum number of operations waiting in the deadlock detector at a time.
- operations_retried
- The number of operations retired due to deadlocks.
- operations_deadlocked
- The number of operations in deadlock.
- cached_attribute_total_size
- The amount of memory in kilobytes used by attribute caching.
- cached_attribute_configured_size
- The amount of memory in kilobytes that can be used by attribute caching.
- cached_attribute_auto_adjust
- Indicates if attribute cache auto adjusting is configured to be on or off.
- cached_attribute_auto_adjust_time
- Indicates the configured time on which to start attribute cache auto adjusting.
- cached_attribute_auto_adjust_time_interval
- Indicates the time interval after which to repeat attribute cache auto adjusting for the day.
- cached_attribute_hit
- The number of times the attribute is used in a filter that could
be processed by the changelog attribute cache. The value is reported
as follows:
cached_attribute_hit=attrname:#####
- cached_attribute_size
- The amount of memory that is used for this attribute in the changelog
attribute cache. This value is reported in kilobytes as follows:
cached_attribute_size=attrname:######
- cached_attribute_candidate_hit
- A list of up to ten most frequently used non-cached attributes
that is used in a filter that is processed by the changelog attribute
cache if all of the attributes that are used in the filter is cached.
The value is reported as follows:
cached_attribute_candidate_hit=attrname:#####
You can use this list to help you decide which attributes you want to cache. Typically, you want to put a limited number of attributes into the attribute cache because of memory constraints.
- currenttime
- The current time on the server. The current time is in the format:
year-month-day hour:minutes:seconds GMT
- starttime
- The time the server was started. The start time is in the format:
year-month-day hour:minutes:seconds GMT
- trace_enabled
- The current trace value for the server. TRUE, if you are collecting trace data, and FALSE, if you are not collecting trace data. See the ldaptrace command information in the Command Reference for information about enabling and starting the trace function.
- trace_message_level
- The current ldap_debug value for the server. The value is in hexadecimal
form, for example:
For more information, see the section on Debugging levels in the Command Reference.0x0=0 0xffff=65535
- trace_message_log
- The current LDAP_DEBUG_FILE environment variable setting for the server.
- auditinfo
- Contains the current audit configuration. This attribute is displayed only if the monitor search is initiated by an administrator.
- en_currentregs
- The current number of client registrations for event notification.
- en_notificationssent
- The total number of event notifications sent to clients since the server was started.
- currentpersistentsearches
- Indicates number of active persistent search connections.
- persistentsearchpendingchanges
- Indicates the number of new updates in the queue that are yet to be processed by the persistent search thread.
- persistentsearchprocessedchanges
- Indicates number of changes that are processed by persistent search process.
- lostpersistentsearchconns
- Indicates the number of lost persistent search connections.
- bypass_deref_aliases
- The server runtime value that indicates if alias processing can be bypassed. It displays true, if no alias object exists in the directory, and false, if at least one alias object exists in the directory.
- available_workers
- The number of worker threads available for work.
- current_workqueue_size
- The current depth of the work queue.
- largest_workqueue_size
- The largest size that the work queue.
- idle_connections_closed
- The number of idle connections closed by the Automatic Connection Cleaner.
- auto_connection_cleaner_run
- The number of times that the Automatic Connection Cleaner is run.
Note: Starting with the IBM® Security
Directory Server 6.3 release, attribute cache is deprecated. Henceforth,
users must avoid using attribute cache.