mirror of
https://github.com/gethomepage/homepage.git
synced 2026-05-19 03:49:14 +08:00
32 lines
1.4 KiB
Markdown
32 lines
1.4 KiB
Markdown
---
|
|
title: Technitium DNS Server
|
|
description: Technitium DNS Server Widget Configuration
|
|
---
|
|
|
|
Learn more about [Technitium DNS Server](https://technitium.com/dns/).
|
|
|
|
Allowed fields (up to 4): `["totalQueries","totalNoError","totalServerFailure","totalNxDomain","totalRefused","totalAuthoritative","totalRecursive","totalCached","totalBlocked","totalDropped","totalClients"]`.
|
|
|
|
Defaults to: `["totalQueries", "totalAuthoritative", "totalCached", "totalServerFailure"]`
|
|
|
|
```yaml
|
|
widget:
|
|
type: technitium
|
|
url: <url to dns server>
|
|
key: biglongapitoken
|
|
node: <node dns name or cluster> # optional, defaults to current node
|
|
range: LastDay # optional, defaults to LastHour
|
|
```
|
|
|
|
#### API Key
|
|
|
|
This can be generated via the Technitium DNS Dashboard, and should be generated from a special API specific user.
|
|
|
|
#### Node
|
|
|
|
`node` value determines which Technitium cluster node the statistics are returned for. Specifying a value of `cluster` returns aggregrate stats for all nodes in the cluster. Specify a node domain name to return specific node stats, no value returns stats for the node against which the API is executed.
|
|
|
|
#### Range
|
|
|
|
`range` value determines how far back of statistics to pull data for. The value comes directly from Technitium API documentation found [here](https://github.com/TechnitiumSoftware/DnsServer/blob/master/APIDOCS.md#dashboard-api-calls), defined as `"type"`. The value can be one of: `LastHour`, `LastDay`, `LastWeek`, `LastMonth`, `LastYear`.
|