IPAM Dashboard

GET /ipam/dashboard/stats

Get DNS/DHCP dashboard statistics

Retrieves Technitium DNS server dashboard statistics including query totals, time-series chart data, query type distribution, top clients, top domains, and top blocked domains for the specified time range.

Query Parameters:

  • type (string) – Time range: LastHour, LastDay, LastWeek, LastMonth, LastYear, Custom (default: LastDay)

  • node (string) – Node domain name for stats, or ‘cluster’ for aggregate cluster stats

  • dontTrimQueryTypeData (boolean) – Set true for full query type data instead of top 10 (default: false)

  • start (string) – ISO 8601 start date (required when type=Custom)

  • end (string) – ISO 8601 end date (required when type=Custom)

Status Codes:
Response JSON Object:

  • mainChartData.datasets[].backgroundColor (string)

  • mainChartData.datasets[].borderColor (string)

  • mainChartData.datasets[].borderWidth (integer)

  • mainChartData.datasets[].data[] (integer)

  • mainChartData.datasets[].fill (boolean)

  • mainChartData.datasets[].label (string)

  • mainChartData.labelFormat (string)

  • mainChartData.labels[] (string)

  • protocolTypeChartData.datasets[].backgroundColor[] (string)

  • protocolTypeChartData.datasets[].data[] (integer)

  • protocolTypeChartData.labels[] (string)

  • queryResponseChartData.datasets[].backgroundColor[] (string)

  • queryResponseChartData.datasets[].data[] (integer)

  • queryResponseChartData.labels[] (string)

  • queryTypeChartData.datasets[].backgroundColor[] (string)

  • queryTypeChartData.datasets[].data[] (integer)

  • queryTypeChartData.labels[] (string)

  • stats.allowListZones (integer)

  • stats.allowedZones (integer)

  • stats.blockListZones (integer)

  • stats.blockedZones (integer)

  • stats.cachedEntries (integer)

  • stats.totalAuthoritative (integer)

  • stats.totalBlocked (integer)

  • stats.totalCached (integer)

  • stats.totalClients (integer)

  • stats.totalDropped (integer)

  • stats.totalNoError (integer)

  • stats.totalNxDomain (integer)

  • stats.totalQueries (integer)

  • stats.totalRecursive (integer)

  • stats.totalRefused (integer)

  • stats.totalServerFailure (integer)

  • stats.zones (integer)

  • topBlockedDomains[].hits (integer)

  • topBlockedDomains[].name (string)

  • topClients[].domain (string)

  • topClients[].hits (integer)

  • topClients[].name (string)

  • topClients[].rateLimited (boolean)

  • topDomains[].hits (integer)

  • topDomains[].name (string)