git.sur5r.net Git - openldap/blob - doc/guide/admin/monitoringslapd.sdf

   1 # $OpenLDAP$
   2 # Copyright 1999, The OpenLDAP Foundation, All Rights Reserved.
   3 # COPYING RESTRICTIONS APPLY, see COPYRIGHT.
   4 H1: Monitoring Slapd
   5
   6 Slapd supports a monitoring interface you can use to find out
   7 many useful bits of information about what slapd is currently
   8 doing, how many connections it has, how many threads are
   9 working, etc. You can access the monitor feature by doing a
  10 base object search of the SLAPD_MONITOR_DN from
  11 include/ldapconfig.h with any kind of valid filter (e.g.,
  12 "(objectclass=*)"). By default, this DN is set to "cn=monitor".
  13 You will get one entry returned to you, with the following
  14 attributes:
  15
  16 E: version: slapd <version> (<date>)
  17
  18 This attribute identifies the slapd server software by name,
  19 version, and build date, e.g., {{EX: slapd 3.3 (Thu May 21 14:19:03
  20 EDT 1996)}}
  21
  22 E: threads: <integer>
  23
  24 This attribute indicates the number of threads (operations)
  25 currently outstanding in slapd.
  26
  27 E: connection: <fd> : <opentime> : <opsinitiated> :
  28 E:      <opscompleted> : <binddn> : [ <rw> ]
  29
  30 This multi-valued attribute summarizes information for each
  31 open connection. The information given is {{EX: <fd>}}, the file
  32 descriptor; {{EX: <opentime>}}, the time the connection was opened
  33 in UTC format; {{EX: <opsinitiated>}}, the number of operations
  34 initiated over the connection; {{EX: <opscompleted>}}, the number
  35 of operations completed over the connection; {{EX: <binddn>}}, the
  36 DN currently bound to the connection; and optionally {{EX: <rw>}},
  37 indicating whether the connection is currently blocked for
  38 read or write..
  39
  40 E: currentconnections: <integer>
  41
  42 The current number of connections.
  43
  44 E: totalconnections: <integer>
  45
  46 The total number of connections handled by slapd since it
  47 started.
  48
  49 E: dtablesize: <integer>
  50
  51 The size of slapd's file descriptor table.
  52
  53 E: writewaiters: <integer>
  54
  55 The number of threads blocked waiting to write data to a
  56 client.
  57
  58 E: readwaiters: <integer>
  59
  60 The number of threads blocked waiting to read data from a
  61 client.
  62
  63 E: opsinitiated: <integer>
  64
  65 The total number of operations initiated by slapd since it
  66 started.
  67
  68 E: opscompleted: <integer>
  69
  70 The total number of operations completed by slapd since it
  71 started.
  72
  73 E: entriessent: <integer>
  74
  75 The total number of entries sent to clients by slapd since it
  76 started.
  77
  78 E: bytessent: <integer>
  79
  80 The total number of bytes sent to clients by slapd since it
  81 started.
  82
  83 E: currenttime: <UTC time>
  84
  85 Slapd's idea of the current time.
  86
  87 E: starttime: <integer>
  88
  89 The time slapd was started.
  90
  91 E: nbackends: <integer>
  92
  93 The number of backends currently being served by slapd.
  94
  95 E: concurrency: <integer>
  96
  97 Under Solaris 2.x only, an indication of the current level of
  98 thread concurrency.
  99
 100 Note that slapd takes a snapshot of this information and
 101 returns it to you. No attempt is made to ensure that the
 102 information is consistent (i.e., if an operation thread is
 103 modifying one of these things when the monitor thread is
 104 reading it, strange results could be returned).
 105
 106 You should be able to use any LDAP client to retrieve this
 107 information. Here's how you might do it using the
 108 {{I: ldapsearch}}(1) client:
 109
 110 E: ldapsearch -s base -b cn=monitor 'objectclass=*'
 111