#include <db_cxx.h> int DbEnv::repmgr_stat(DB_REPMGR_STAT **statp, u_int32_t flags);
The DbEnv::repmgr_stat() method returns the Replication Manager
statistics.
The DbEnv::repmgr_stat() method creates a statistical structure of
type DB_REPMGR_STAT and copies a pointer to it into a user-specified
memory location.
Statistical structures are stored in allocated memory. If application-specific allocation routines have been declared (see DbEnv::set_alloc() for more information), they are used to allocate the memory; otherwise, the standard C library malloc(3) is used. The caller is responsible for deallocating the memory. To deallocate the memory, free the memory reference; references inside the returned memory need not be individually freed.
The following DB_REPMGR_STAT fields will be filled in:
uintmax_t st_connect_fail;
The number of times an attempt to open a new TCP/IP connection failed.
uintmax_t st_connection_drop;
The number of times an existing TCP/IP connection failed.
uintmax_t st_msgs_dropped;
The number of outgoing messages that were completely dropped, because the outgoing message queue was full. (Berkeley DB replication is tolerant of dropped messages, and will automatically request retransmission of any missing messages as needed.)
uintmax_t st_msgs_queued;
The number of outgoing messages which could not be transmitted immediately, due to a full network buffer, and had to be queued for later delivery.
uintmax_t st_perm_failed;
The number of times a message critical for maintaining database integrity (for example, a transaction commit), originating at this site, did not receive sufficient acknowledgement from clients, according to the configured acknowledgement policy and acknowledgement timeout.
The DbEnv::repmgr_stat() method may not be called before the
DbEnv::open() method is called.
The DbEnv::repmgr_stat()
method either returns a non-zero error value or throws an
exception that encapsulates a non-zero error value on
failure, and returns 0 on success.
The flags parameter must be set to 0 or the following value:
DB_STAT_CLEAR
Reset statistics after returning their values.
The DbEnv::repmgr_stat()
method may fail and throw a DbException
exception, encapsulating one of the following non-zero errors, or return one
of the following non-zero errors:
If the method was called before DbEnv::open() was called; or if an invalid flag value or parameter was specified.