Getting XDCR stats

Getting XDCR stats

All XDCR statistical requests use the UUID, a unique identifier for destination cluster. The UUID is retrieved with the GET /pools/default/remoteClusters HTTP method and URI. Many of these statistics are exposed in the Couchbase web console.

Important: You need to provide a properly URL-encoded URI string for the destination endpoint when requesting XDCR statistics.

HTTP method and URI

The destination endpoint follows the /pools/default/buckets/[bucket_name]/stats/ URI endpoint:

GET /pools/default/buckets/[bucket_name]/stats/[destination_endpoint]
                

Where the destination endpoint is:

replications/[remote_UUID]/[source_bucket]/[destination_bucket]/[stat_name]

Where the HTTP endpoint string with full URI is:

http://[localhost]:[port]/pools/default/buckets/[bucket_name]/stats/replications/[remote_UUID]/[source_bucket]/[destination_bucket]/[stat_name]
                

Where the HTTP string with a properly URL-encoded URI is:

http://[localhost]:[port]/pools/default/buckets/[bucket_name]/stats/replications%2F[remote_UUID]%2F[source_bucket]%2F[destination_bucket]%2F[stat_name]
Stat name Description
docs_written Number of documents written to the destination cluster via XDCR.
data_replicated Size of data replicated in bytes.
changes_left Number of updates still pending replication.
docs_checked Number of documents checked for changes.
num_checkpoints Number of checkpoints issued in replication queue.
num_failedckpts Number of checkpoints failed during replication.
size_rep_queue Size of replication queue in bytes.
active_vbreps Active vBucket replicators.
waiting_vbreps Waiting vBucket replicators.
time_committing Seconds elapsed during replication.
time_working Time working in seconds including wait time.
bandwidth_usage Bandwidth used during replication.
docs_latency_aggr Aggregate time waiting to send changes to destination cluster in milliseconds.
docs_latency_wt Weighted average latency for sending replicated changes to destination cluster.
docs_rep_queue Number of documents in replication queue.
meta_latency_aggr Aggregate time to request and receive metadata about documents. XDCR uses this for conflict resolution prior to sending the document into the replication queue.
meta_latency_wt Weighted average time for requesting document metadata. XDCR uses this for conflict resolution prior to sending the document into the replication queue.
rate_replication Bytes replicated per second.
docs_opt_repd Number of docs sent optimistically.