Decider Statistics REST Interface

Data

'last-10-minutes': [(timestamp, value), (timestamp, value), ...] 'last-hour': [(timestamp, value), (timestamp, value), ...] 'last-day': [(timestamp, value), ....] }

timestamp is a Unix timestamp (seconds since 1970-01-01 00:00 GMT).

value is a floating point value.

The different lists have different resolutions: In the last-10-minutes and in the last-hour view, the values are consolidated per minute. The last-day view contains consolidated values every 5 minutes. The resolution dictionary reflects this and contains the value of the resolution in seconds. For example, in the last-day view, a value is consolidated every 5 minutes, which equals 5*60=300 seconds.

ATTENTION
Note that all static data is about 3 minutes old. In particular, this also applies to the last-10-minutes view.

The bound_master dict and the forced_bound_master dict have the following fields:

• master_id: The internal master ID (this ID is unique in the whole cluster)
• master_ip: The IP address of the administration node that’s seen by the decider node. This IP address may differ from the administration node IP address in the cluster.

Getting the free memory of a decider node

• Request

  Method	GET
  URL	/cluster/deciders/NODEID/stats/free-memory
  Arguments	–

• Response

  Return code	Arguments	Meaning
  200		successfully returned a dictionary with the requested data (in megabytes)
  401	-	no login
  403	-	not enough rights
  404	-	decider node not found
  500	-	internal server error

• Example

  $ curl -u admin:admin http://localhost:8087/api/af/2.0/cluster/deciders/192.168.240.1:8086/stats/free-memory { "__name": "free-memory", "__path": "/api/af/2.0/cluster/deciders/192.168.240.1:8086/stats/free-memory/", "__subnodes": [ "last-10-minutes", "last-hour", "last-day" ] }

  To obtain the actual data, you must decide on the resolution that you want:

  curl -u admin:admin http://localhost:8087/api/af/2.0/cluster/deciders/192.168.240.1:8086/stats/free-memory/last-hour { "__name": "last-hour", "__path": "/api/af/2.0/cluster/deciders/192.168.240.1:8086/stats/free-memory/last-hour/", "__subnodes": [], "data": [ [ 1352276474, 45.0 ], [ .. }

Getting the number of requests per minute

• Request

  Method	GET
  URL	/cluster/deciders/NODEID/stats/requests-per-minute
  Arguments	–

• Response

  Return code	Arguments	Meaning
  200	{ ... }	successfully returned a dictionary with the requested data
  401	-	no login
  403	-	not enough rights
  404	-	decider node not found
  500	-	internal server error

• Example

  $ curl -u admin:admin -H 'Content-Type: application/json' http://127.0.0.1:8087/api/af/2.0/cluster/deciders/127.0.0.1:8086/stats/requests-per-minute { "__name": "requests-per-minute", "__path": "/api/af/2.0/cluster/deciders/127.0.0.1:8086/stats/requests-per-minute/", "__subnodes": [ "last-10-minutes", "last-hour", "last-day" ] }

Getting the load of a decider node

• Request

  Method	GET
  URL	/cluster/deciders/NODEID/stats/load
  Arguments	–

• Response

  Return code	Arguments	Meaning
  200	{ ... }	successfully returned a dictionary with the requested data
  401	-	no login
  403	-	not enough rights
  404	-	decider node not found
  500	-	internal server error

• Example

  $ curl -u admin:admin http://localhost:8087/api/af/2.0/cluster/deciders/192.168.240.1:8086/stats/load/last-hour { "__name": "last-hour", "__path": "/api/af/2.0/cluster/deciders/192.168.240.1:8086/stats/load/last-hour/", "__subnodes": [], "data": [ [ 1351785759, 0.51 ], [ 1351785819, 0.18 ], ... [ 1351789299, 0.16 ] ], "resolution": 60 }

Getting the free log space of a decider node

• Request

  Method	GET
  URL	/cluster/deciders/NODEID/stats/free-log-diskspace
  Arguments	–

• Response

  Return code	Arguments	Meaning
  200	{ ... }	successfully returned a dictionary with the requested data (in megabytes)
  401	-	no login
  403	-	not enough rights
  404	-	decider node not found
  500	-	internal server error