DataStax Agent API example curl commands

A few examples of useful curl commands demonstrating the DataStax Agent API.

Examples 

opscenterd.log

The location of the opscenterd.log file depends on the type of installation:
  • Package installations: /var/log/opscenter/opscenterd.log
  • Tarball installations: install_location/log/opscenterd.log
Use the DataStax Agent API with cURL commands to directly hit an agent for useful information when troubleshooting an issue. Check the size of a diagnostic file before downloading. Determine the root cause of connection issues. Some useful curl commands:
  • curl "http://agentIP:61621/v1/check-diagnostics-size" before getting diagnostics, which could take a substantial amount of time using curl -X GET --header 'Accept: application/json' 'http://localhost:61621/v1/diagnostics'.
  • If you see connection-status failed messages in the opscenterd.log, get more details using curl "http://54.152.37.135:61621/v1/connection-status" | json_pp (piped to JSON pretty print):
    $ curl "http://54.152.37.135:61621/connection-status" | json_pp
      % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                     Dload  Upload   Total   Spent    Left  Speed
    100   935  100   935    0     0   3571      0 --:--:-- --:--:-- --:--:--  3582
    {
       "storage_cassandra" : {
          "config" : {
             "storage-keyspace" : "OpsCenter",
             "storage-port" : 9042,
             "storage-hosts" : [
                "172.31.6.241"
             ],
             "storage-cassandra-user" : null,
             "error" : "Authentication error on host /172.31.6.241:9042: Host /172.31.6.241:9042 requires authentication, but no authenticator found in Cluster configuration"
          },
          "started" : false
       },
       "install-type" : "package",
       "stomp" : {
          "started" : true,
          "config" : {
             "error" : null,
             "stomp-interface" : "172.31.0.97",
             "stomp-port" : 61620,
             "use-ssl?" : false
          }
       },
       "monitored_cassandra" : {
          "config" : {
             "monitored-cassandra-user" : null,
             "monitored-hosts" : [
                "172.31.6.241"
             ],
             "error" : "Authentication error on host /172.31.6.241:9042: Host /172.31.6.241:9042 requires authentication, but no authenticator found in Cluster configuration",
             "monitored-port" : 9042
          },
          "started" : false
       },
       "http" : {
          "config" : {
             "agent-rpc-interface" : "172.31.6.241",
             "api-port" : 61621,
             "use-ssl" : false
          }
       },
       "jmx" : {
          "started" : true,
          "config" : {
             "jmx-port" : 7199,
             "error" : null,
             "jmx-user" : null
          }
       }
    }