A newer version of this documentation is available.

View Latest

Retrieving Statistics

    +
    To retrieve statistics for a node, first retrieve a list of nodes

    Description

    To obtain statistics for a node:

    1. Retrieve a list of nodes in a cluster.

    2. Send the statistics request using the IP address and port for a node in the cluster.

    HTTP method and URI

    GET /pools/default/buckets/default/nodes/[host]:[port]/stats

    Syntax

    Curl request syntax to retrieve a list of nodes:

    curl -u [admin]:[password] http://[localhost]:[port]/pools/default/buckets/default/nodes

    Curl request syntax to retrieve statistics about a node:

    curl -u a[admin]:[password] http://[localhost]: \
              [port]/pools/default/buckets/default/nodes/[localhost]%3A[port]/stats

    Example

    Curl request example that retrieves a list of nodes from a cluster:

    curl -u Administrator:password http://10.5.2.118:8091/pools/default/buckets/default/nodes

    The curl request for a node list sends the following HTTP request:

    GET /pools/default/buckets/default/nodes HTTP/1.1
    User-Agent: curl/7.21.4 (universal-apple-darwin11.0) libcurl/7.21.4 OpenSSL/0.9.8r zlib/1.2.5
    Host: 10.5.2.118:8091
    Accept: */*

    If Couchbase Server successfully handles the request, a response similar to the following displays:

    {"servers":[
      {"hostname":"10.5.2.118:8091",
      "uri":"/pools/default/buckets/default/nodes/10.5.2.118%3A8091",
      "stats":
          {"uri":"/pools/default/buckets/default/nodes/10.5.2.118%3A8091/stats"}}
        ....

    Curl request example to retrieve statistics for a specific server node. Use the node’s IP address and port shown in the response and add /stats as the endpoint:

    curl -u Administrator:password \
     http://10.5.2.118:8091/pools/default/buckets/default/nodes/10.5.2.118%3A8091/stats

    The curl request for a node’s statistics sends the following HTTP request:

    GET /pools/default/buckets/default/nodes/10.4.2.4%3A8091/stats HTTP/1.1
    User-Agent: curl/7.21.4 (universal-apple-darwin11.0) libcurl/7.21.4 OpenSSL/0.9.8r zlib/1.2.5
    Host: 10.4.2.4:8091
    Accept: */*

    Response

    The following statistics returned are for the individual bucket associated with that node in the previous example.

    {"hostname":"10.5.2.118:8091","hot_keys":[{"name":"[2012-11-05::3:47:01]"
    ....
    "samplesCount":60,"isPersistent":true,"lastTStamp":1352922180718,"interval":1000}}