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