Changeset View
Changeset View
Standalone View
Standalone View
files/man/ctdb-statistics.7
Property | Old Value | New Value |
---|---|---|
svn:eol-style | null | native \ No newline at end of property |
svn:keywords | null | FreeBSD=%H \ No newline at end of property |
svn:mime-type | null | text/plain \ No newline at end of property |
'\" t | |||||
.\" Title: ctdb-statistics | |||||
.\" Author: | |||||
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> | |||||
.\" Date: 11/18/2018 | |||||
.\" Manual: CTDB - clustered TDB database | |||||
.\" Source: ctdb | |||||
.\" Language: English | |||||
.\" | |||||
.TH "CTDB\-STATISTICS" "7" "11/18/2018" "ctdb" "CTDB \- clustered TDB database" | |||||
.\" ----------------------------------------------------------------- | |||||
.\" * Define some portability stuff | |||||
.\" ----------------------------------------------------------------- | |||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |||||
.\" http://bugs.debian.org/507673 | |||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html | |||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |||||
.ie \n(.g .ds Aq \(aq | |||||
.el .ds Aq ' | |||||
.\" ----------------------------------------------------------------- | |||||
.\" * set default formatting | |||||
.\" ----------------------------------------------------------------- | |||||
.\" disable hyphenation | |||||
.nh | |||||
.\" disable justification (adjust text to left margin only) | |||||
.ad l | |||||
.\" ----------------------------------------------------------------- | |||||
.\" * MAIN CONTENT STARTS HERE * | |||||
.\" ----------------------------------------------------------------- | |||||
.SH "NAME" | |||||
ctdb-statistics \- CTDB statistics output | |||||
.SH "OVERALL STATISTICS" | |||||
.PP | |||||
CTDB maintains information about various messages communicated and some of the important operations per node\&. See the | |||||
\fBctdb\fR(1) | |||||
commands | |||||
\fBstatistics\fR | |||||
and | |||||
\fBstatisticsreset\fR | |||||
for displaying statistics\&. | |||||
.SS "Example: ctdb statistics" | |||||
.sp | |||||
.if n \{\ | |||||
.RS 4 | |||||
.\} | |||||
.nf | |||||
CTDB version 1 | |||||
Current time of statistics : Fri Sep 12 13:32:32 2014 | |||||
Statistics collected since : (000 01:49:20) Fri Sep 12 11:43:12 2014 | |||||
num_clients 6 | |||||
frozen 0 | |||||
recovering 0 | |||||
num_recoveries 2 | |||||
client_packets_sent 281293 | |||||
client_packets_recv 296317 | |||||
node_packets_sent 452387 | |||||
node_packets_recv 182394 | |||||
keepalive_packets_sent 3927 | |||||
keepalive_packets_recv 3928 | |||||
node | |||||
req_call 48605 | |||||
reply_call 1 | |||||
req_dmaster 23404 | |||||
reply_dmaster 24917 | |||||
reply_error 0 | |||||
req_message 958 | |||||
req_control 197513 | |||||
reply_control 153705 | |||||
client | |||||
req_call 130866 | |||||
req_message 770 | |||||
req_control 168921 | |||||
timeouts | |||||
call 0 | |||||
control 0 | |||||
traverse 0 | |||||
locks | |||||
num_calls 220 | |||||
num_current 0 | |||||
num_pending 0 | |||||
num_failed 0 | |||||
total_calls 130866 | |||||
pending_calls 0 | |||||
childwrite_calls 1 | |||||
pending_childwrite_calls 0 | |||||
memory_used 334490 | |||||
max_hop_count 18 | |||||
total_ro_delegations 2 | |||||
total_ro_revokes 2 | |||||
hop_count_buckets: 42816 5464 26 1 0 0 0 0 0 0 0 0 0 0 0 0 | |||||
lock_buckets: 9 165 14 15 7 2 2 0 0 0 0 0 0 0 0 0 | |||||
locks_latency MIN/AVG/MAX 0\&.000685/0\&.160302/6\&.369342 sec out of 214 | |||||
reclock_ctdbd MIN/AVG/MAX 0\&.004940/0\&.004969/0\&.004998 sec out of 2 | |||||
reclock_recd MIN/AVG/MAX 0\&.000000/0\&.000000/0\&.000000 sec out of 0 | |||||
call_latency MIN/AVG/MAX 0\&.000006/0\&.000719/4\&.562991 sec out of 126626 | |||||
childwrite_latency MIN/AVG/MAX 0\&.014527/0\&.014527/0\&.014527 sec out of 1 | |||||
.fi | |||||
.if n \{\ | |||||
.RE | |||||
.\} | |||||
.SS "CTDB version" | |||||
.PP | |||||
Version of the ctdb protocol used by the node\&. | |||||
.SS "Current time of statistics" | |||||
.PP | |||||
Time when the statistics are generated\&. | |||||
.PP | |||||
This is useful when collecting statistics output periodically for post\-processing\&. | |||||
.SS "Statistics collected since" | |||||
.PP | |||||
Time when ctdb was started or the last time statistics was reset\&. The output shows the duration and the timestamp\&. | |||||
.SS "num_clients" | |||||
.PP | |||||
Number of processes currently connected to CTDB\*(Aqs unix socket\&. This includes recovery daemon, ctdb tool and samba processes (smbd, winbindd)\&. | |||||
.SS "frozen" | |||||
.PP | |||||
1 if the the databases are currently frozen, 0 otherwise\&. | |||||
.SS "recovering" | |||||
.PP | |||||
1 if recovery is active, 0 otherwise\&. | |||||
.SS "num_recoveries" | |||||
.PP | |||||
Number of recoveries since the start of ctdb or since the last statistics reset\&. | |||||
.SS "client_packets_sent" | |||||
.PP | |||||
Number of packets sent to client processes via unix domain socket\&. | |||||
.SS "client_packets_recv" | |||||
.PP | |||||
Number of packets received from client processes via unix domain socket\&. | |||||
.SS "node_packets_sent" | |||||
.PP | |||||
Number of packets sent to the other nodes in the cluster via TCP\&. | |||||
.SS "node_packets_recv" | |||||
.PP | |||||
Number of packets received from the other nodes in the cluster via TCP\&. | |||||
.SS "keepalive_packets_sent" | |||||
.PP | |||||
Number of keepalive messages sent to other nodes\&. | |||||
.PP | |||||
CTDB periodically sends keepalive messages to other nodes\&. See | |||||
KeepaliveInterval | |||||
tunable in | |||||
\fBctdb-tunables\fR(7) | |||||
for more details\&. | |||||
.SS "keepalive_packets_recv" | |||||
.PP | |||||
Number of keepalive messages received from other nodes\&. | |||||
.SS "node" | |||||
.PP | |||||
This section lists various types of messages processed which originated from other nodes via TCP\&. | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBreq_call\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of REQ_CALL messages from the other nodes\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBreply_call\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of REPLY_CALL messages from the other nodes\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBreq_dmaster\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of REQ_DMASTER messages from the other nodes\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBreply_dmaster\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of REPLY_DMASTER messages from the other nodes\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBreply_error\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of REPLY_ERROR messages from the other nodes\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBreq_message\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of REQ_MESSAGE messages from the other nodes\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBreq_control\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of REQ_CONTROL messages from the other nodes\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBreply_control\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of REPLY_CONTROL messages from the other nodes\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBreq_tunnel\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of REQ_TUNNEL messages from the other nodes\&. | |||||
.RE | |||||
.SS "client" | |||||
.PP | |||||
This section lists various types of messages processed which originated from clients via unix domain socket\&. | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBreq_call\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of REQ_CALL messages from the clients\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBreq_message\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of REQ_MESSAGE messages from the clients\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBreq_control\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of REQ_CONTROL messages from the clients\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBreq_tunnel\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of REQ_TUNNEL messages from the clients\&. | |||||
.RE | |||||
.SS "timeouts" | |||||
.PP | |||||
This section lists timeouts occurred when sending various messages\&. | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBcall\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of timeouts for REQ_CALL messages\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBcontrol\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of timeouts for REQ_CONTROL messages\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBtraverse\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of timeouts for database traverse operations\&. | |||||
.RE | |||||
.SS "locks" | |||||
.PP | |||||
This section lists locking statistics\&. | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBnum_calls\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of completed lock calls\&. This includes database locks and record locks\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBnum_current\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of scheduled lock calls\&. This includes database locks and record locks\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBnum_pending\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of queued lock calls\&. This includes database locks and record locks\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBnum_failed\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of failed lock calls\&. This includes database locks and record locks\&. | |||||
.RE | |||||
.SS "total_calls" | |||||
.PP | |||||
Number of req_call messages processed from clients\&. This number should be same as client \-\-> req_call\&. | |||||
.SS "pending_calls" | |||||
.PP | |||||
Number of req_call messages which are currenly being processed\&. This number indicates the number of record migrations in flight\&. | |||||
.SS "childwrite_calls" | |||||
.PP | |||||
Number of record update calls\&. Record update calls are used to update a record under a transaction\&. | |||||
.SS "pending_childwrite_calls" | |||||
.PP | |||||
Number of record update calls currently active\&. | |||||
.SS "memory_used" | |||||
.PP | |||||
The amount of memory in bytes currently used by CTDB using talloc\&. This includes all the memory used for CTDB\*(Aqs internal data structures\&. This does not include the memory mapped TDB databases\&. | |||||
.SS "max_hop_count" | |||||
.PP | |||||
The maximum number of hops required for a record migration request to obtain the record\&. High numbers indicate record contention\&. | |||||
.SS "total_ro_delegations" | |||||
.PP | |||||
Number of readonly delegations created\&. | |||||
.SS "total_ro_revokes" | |||||
.PP | |||||
Number of readonly delegations that were revoked\&. The difference between total_ro_revokes and total_ro_delegations gives the number of currently active readonly delegations\&. | |||||
.SS "hop_count_buckets" | |||||
.PP | |||||
Distribution of migration requests based on hop counts values\&. Buckets are 1, < 4, < 8, < 16, < 32, < 64, < 128, < 256, < 512, ≥ 512\&. | |||||
.SS "lock_buckets" | |||||
.PP | |||||
Distribution of record lock requests based on time required to obtain locks\&. Buckets are < 1ms, < 10ms, < 100ms, < 1s, < 2s, < 4s, < 8s, < 16s, < 32s, < 64s, ≥ 64s\&. | |||||
.SS "locks_latency" | |||||
.PP | |||||
The minimum, the average and the maximum time (in seconds) required to obtain record locks\&. | |||||
.SS "reclock_ctdbd" | |||||
.PP | |||||
The minimum, the average and the maximum time (in seconds) required to check if recovery lock is still held by recovery daemon when recovery mode is changed\&. This check is done in ctdb daemon\&. | |||||
.SS "reclock_recd" | |||||
.PP | |||||
The minimum, the average and the maximum time (in seconds) required to check if recovery lock is still held by recovery daemon during recovery\&. This check is done in recovery daemon\&. | |||||
.SS "call_latency" | |||||
.PP | |||||
The minimum, the average and the maximum time (in seconds) required to process a REQ_CALL message from client\&. This includes the time required to migrate a record from remote node, if the record is not available on the local node\&. | |||||
.SS "childwrite_latency" | |||||
.PP | |||||
Default: 0 | |||||
.PP | |||||
The minimum, the average and the maximum time (in seconds) required to update records under a transaction\&. | |||||
.SH "DATABASE STATISTICS" | |||||
.PP | |||||
CTDB maintains per database statistics about important operations\&. See the | |||||
\fBctdb\fR(1) | |||||
command | |||||
\fBdbstatistics\fR | |||||
for displaying database statistics\&. | |||||
.SS "Example: ctdb dbstatistics notify_index\&.tdb" | |||||
.sp | |||||
.if n \{\ | |||||
.RS 4 | |||||
.\} | |||||
.nf | |||||
DB Statistics: notify_index\&.tdb | |||||
ro_delegations 0 | |||||
ro_revokes 0 | |||||
locks | |||||
total 131 | |||||
failed 0 | |||||
current 0 | |||||
pending 0 | |||||
hop_count_buckets: 9890 5454 26 1 0 0 0 0 0 0 0 0 0 0 0 0 | |||||
lock_buckets: 4 117 10 0 0 0 0 0 0 0 0 0 0 0 0 0 | |||||
locks_latency MIN/AVG/MAX 0\&.000683/0\&.004198/0\&.014730 sec out of 131 | |||||
Num Hot Keys: 3 | |||||
Count:7 Key:2f636c75737465726673 | |||||
Count:18 Key:2f636c757374657266732f64617461 | |||||
Count:7 Key:2f636c757374657266732f646174612f636c69656e7473 | |||||
.fi | |||||
.if n \{\ | |||||
.RE | |||||
.\} | |||||
.SS "DB Statistics" | |||||
.PP | |||||
Name of the database\&. | |||||
.SS "ro_delegations" | |||||
.PP | |||||
Number of readonly delegations created in the database\&. | |||||
.SS "ro_revokes" | |||||
.PP | |||||
Number of readonly delegations revoked\&. The difference in ro_delegations and ro_revokes indicates the currently active readonly delegations\&. | |||||
.SS "locks" | |||||
.PP | |||||
This section lists locking statistics\&. | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBtotal\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of completed lock calls\&. This includes database locks and record locks\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBfailed\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of failed lock calls\&. This includes database locks and record locks\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBcurrent\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of scheduled lock calls\&. This includes database locks and record locks\&. | |||||
.RE | |||||
.sp | |||||
.it 1 an-trap | |||||
.nr an-no-space-flag 1 | |||||
.nr an-break-flag 1 | |||||
.br | |||||
.ps +1 | |||||
\fBpending\fR | |||||
.RS 4 | |||||
.PP | |||||
Number of queued lock calls\&. This includes database locks and record locks\&. | |||||
.RE | |||||
.SS "hop_count_buckets" | |||||
.PP | |||||
Distribution of migration requests based on hop counts values\&. Buckets are 1, < 4, < 8, < 16, < 32, < 64, < 128, < 256, < 512, ≥ 512\&. | |||||
.SS "lock_buckets" | |||||
.PP | |||||
Distribution of record lock requests based on time required to obtain locks\&. Buckets are < 1ms, < 10ms, < 100ms, < 1s, < 2s, < 4s, < 8s, < 16s, < 32s, < 64s, ≥ 64s\&. | |||||
.SS "locks_latency" | |||||
.PP | |||||
The minimum, the average and the maximum time (in seconds) required to obtain record locks\&. | |||||
.SS "Num Hot Keys" | |||||
.PP | |||||
Number of contended records determined by hop count\&. CTDB keeps track of top 10 hot records and the output shows hex encoded keys for the hot records\&. | |||||
.SH "SEE ALSO" | |||||
.PP | |||||
\fBctdb\fR(1), | |||||
\fBctdbd\fR(1), | |||||
\fBctdb-tunables\fR(7), | |||||
\m[blue]\fB\%http://ctdb.samba.org/\fR\m[] | |||||
.SH "AUTHOR" | |||||
.br | |||||
.PP | |||||
This documentation was written by Amitay Isaacs, Martin Schwenke | |||||
.SH "COPYRIGHT" | |||||
.br | |||||
Copyright \(co 2007 Andrew Tridgell, Ronnie Sahlberg | |||||
.br | |||||
.PP | |||||
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version\&. | |||||
.PP | |||||
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE\&. See the GNU General Public License for more details\&. | |||||
.PP | |||||
You should have received a copy of the GNU General Public License along with this program; if not, see | |||||
\m[blue]\fB\%http://www.gnu.org/licenses\fR\m[]\&. | |||||
.sp |