Tip of the day: Channel mode +H provides Channel history to modern clients. Optionally, it can be stored on-disk to be preserved between server restarts.

JSON-RPC:Stats

From UnrealIRCd documentation wiki
Jump to navigation Jump to search

The stats.* JSON RPC calls can be used to fetch statistics.

API Calls

stats.get

Get some quick basic statistics. This is for example used by the admin panel for the 'Overview' page.

Request arguments

Mandatory arguments:

  • None

Optional arguments:

  • object_detail_level: set the detail of the response object. The user.countries will be included from level 1+. The default object_detail_level is 1.

Response

Withing the result object the following fields are available that describe total counts network-wide (global):

"server": {
  "total": 1,
  "ulined": 0
},
"user": {
  "total": 1,
  "ulined": 0,
  "oper": 1,
  "record": 510,
  "countries": [
    {
      "country": "NL",
      "count": 1
    }
  ]
},
"channel": {
  "total": 0
},
"server_ban": {
  "total": 27,
  "server_ban": 2,
  "spamfilter": 3,
  "name_ban": 18,
  "server_ban_exception": 4
}

The above fields should speak for themselves. One important thing to note is that users.oper does not include u-lines (so services bots with +o are not included in 'oper').

Example

Request:

{"jsonrpc": "2.0", "method": "stats.get", "params": {}, "id": 123}