Statistics

Endpoints

GET /servers/{server_id}/statistics

Query statistics.

Query PowerDNS internal statistics.

Parameters:
  • server_id (string) – The id of the server to retrieve
Query Parameters:
 
  • statistic (string) – When set to the name of a specific statistic, only this value is returned. If no statistic with that name exists, the response has a 422 status and an error message.
Status Codes:
  • 200 OK – List of Statistic Items Returns: array
  • 422 Unprocessable Entity – Returned when a non-existing statistic name has been requested. Contains an error message

Objects

The Statistics endpoint returns an array of objects that can be StatisticItem, MapStatisticItem or RingStatisticItem :

StatisticItem
Object Properties:
 
  • name (string) – Item name
  • type (string) – set to “StatisticItem”
  • value (string) – Item value
MapStatisticItem
Object Properties:
 
RingStatisticItem
Object Properties:
 

Both MapStatisticItem and RingStatisticItem objects contains an array of SimpleStatisticItem

SimpleStatisticItem
Object Properties: