A newer version of this documentation is available.

View Latest

Health Check

    +
    Health Check provides ping() and diagnostics() tests for the health of the network and the cluster.

    Unresolved include directive in modules/concept-docs/pages/health-check.adoc - include::7.1@sdk:pages:partial$health-check.adoc[]

    Unresolved include directive in modules/concept-docs/pages/health-check.adoc - include::7.1@sdk:pages:partial$health-check.adoc[]

    Ping

    A call to ping actively sends requests to the different services on the target cluster, measuring the latency and returning any errors as part of the report.

    A ping can be performed either at the Cluster or at the Bucket level. They are very similar, although at the Bucket level also the Key/Value and View connections for the specific bucket are taken into account.

    The report can either be analyzed in code or can be turned into JSON and printed:

    PingResult pingResult = cluster.ping();
    
    System.out.println(pingResult.exportToJson());

    You will see an output similar to this:

    {
       "services":{
          "query":[
             {
                "latency_us":1622,
                "state":"ok",
                "id":"0x01e2bef7",
                "remote":"10.143.200.101:8093",
                "local":"10.143.200.1:59775"
             },
             {
                "latency_us":1911,
                "state":"ok",
                "id":"0x8dff2eb6",
                "remote":"10.143.200.102:8093",
                "local":"10.143.200.1:59778"
             }
          ]
       },
       "sdk":"java/0.0.0 (Mac OS X 10.15.4 x86_64; OpenJDK 64-Bit Server VM 13+33)",
       "id":"fcc08fb8-5a56-40aa-8967-47bc7517382d",
       "version":2
    }

    On the target system, only the query service has been enabled at the cluster level according to this report. If you have more services configured (for example analytics or search) you could achieve the same effect by asking for only the query service to ping explicitly:

          PingResult pingResult = cluster.ping(pingOptions().serviceTypes(EnumSet.of(ServiceType.QUERY)));
    
          System.out.println(pingResult.exportToJson());

    If the ping is performed at the bucket level, the Key/Value and View sockets are also visible:

    {
       "services":{
          "query":[
             {
                "latency_us":1364,
                "state":"ok",
                "id":"0x178a666c",
                "remote":"10.143.200.102:8093",
                "local":"10.143.200.1:59864"
             },
             {
                "latency_us":1343,
                "state":"ok",
                "id":"0x65cda678",
                "remote":"10.143.200.101:8093",
                "local":"10.143.200.1:59865"
             }
          ],
          "kv":[
             {
                "latency_us":703,
                "namespace":"travel-sample",
                "state":"ok",
                "id":"0x2e2abd35",
                "remote":"10.143.200.102:11210",
                "local":"10.143.200.1:59869"
             },
             {
                "latency_us":1260,
                "namespace":"travel-sample",
                "state":"ok",
                "id":"0xf3fc7e9f",
                "remote":"10.143.200.101:11210",
                "local":"10.143.200.1:59868"
             }
          ],
          "views":[
             {
                "latency_us":9547,
                "namespace":"travel-sample",
                "state":"ok",
                "id":"0x712e8eca",
                "remote":"10.143.200.102:8092",
                "local":"10.143.200.1:59871"
             },
             {
                "latency_us":7863,
                "namespace":"travel-sample",
                "state":"ok",
                "id":"0x2c988f93",
                "remote":"10.143.200.101:8092",
                "local":"10.143.200.1:59873"
             }
          ]
       },
       "sdk":"java/0.0.0 (Mac OS X 10.15.4 x86_64; OpenJDK 64-Bit Server VM 13+33)",
       "id":"3ffecdae-5abe-413b-aa26-c2b2774ef872",
       "version":2
    }

    Diagnostics

    Performing a diagnostics() call at the Cluster level is conceptually different from a ping, but still very useful. It returns information about the current state of all the connections inside the SDK without actually performing any I/O. So if you haven’t done any operations against a service with a pool (i.e. Query) you might not see any sockets show up.

    Similar to ping, you can turn a diagnostics result into JSON. The following code and output shows a state directly after bootstrap, without performing any query operations:

          DiagnosticsResult diagnosticsResult = cluster.diagnostics();
    
          for (Map.Entry<ServiceType, List<EndpointDiagnostics>> service : diagnosticsResult.endpoints().entrySet()) {
            for (EndpointDiagnostics ed : service.getValue()) {
              System.err.println(
                  service.getKey() + ": " + ed.remote() + " last activity  " + ed.lastActivity()
              );
            }
          }
    {
       "services":{
          "kv":[
             {
                "state":"connecting"
             }
          ]
       },
       "sdk":"java/0.0.0 (Mac OS X 10.15.4 x86_64; OpenJDK 64-Bit Server VM 13+33)",
       "id":"484f20c4-f9c8-47c9-90b1-6901279066b0",
       "state":"offline",
       "version":2
    }

    If you perform a query and look at the diagnostics again, you’ll see them show up in the report:

    {
       "services":{
          "query":[
             {
                "last_activity_us":3306,
                "state":"connected",
                "id":"0x809fa38a",
                "remote":"10.143.200.1:61127",
                "local":"10.143.200.101:8093"
             },
             {
                "state":"connected",
                "id":"0xc292ca2d",
                "remote":"10.143.200.1:61128",
                "local":"10.143.200.102:8093"
             }
          ],
          "kv":[
             {
                "last_activity_us":751662,
                "state":"connected",
                "id":"0x35b05053",
                "remote":"10.143.200.1:61125",
                "local":"10.143.200.101:11210"
             },
             {
                "last_activity_us":751304,
                "state":"connected",
                "id":"0x4510d5e8",
                "remote":"10.143.200.1:61126",
                "local":"10.143.200.102:11210"
             }
          ]
       },
       "sdk":"java/0.0.0 (Mac OS X 10.15.4 x86_64; OpenJDK 64-Bit Server VM 13+33)",
       "id":"167f0f08-a6e0-4aca-8832-4e3ab688820e",
       "state":"online",
       "version":2
    }