---
title: Decider Statistics REST Interface
slug: ps/help/en_us/vwaf/ag/decider-statistics-rest-interface
docTags: 
createdAt: 2026-08-02T10:05:41.887Z
---

## Data

```bash
'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

  ```bash
  $ 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:

```bash
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

  ```bash
  $ 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

  ```bash
  $ 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                                                     |