Pull request 159: 4299-querylog-stats-ignore

Merge in DNS/adguard-home-wiki from 4299-querylog-stats-ignore to master

Squashed commit of the following:

commit 4512fa57560fd7dc4d1b0b8486131da7accacb45
Author: Stanislav Chzhen <s.chzhen@adguard.com>
Date:   Fri Feb 10 19:11:35 2023 +0300

    colon

commit db6df2dc6add0c48a878dfba1a8fa1181096ea23
Author: Stanislav Chzhen <s.chzhen@adguard.com>
Date:   Fri Feb 10 18:51:51 2023 +0300

    before and since

commit 4e17260565512cffdbf755a0f2e2cfe32942435e
Author: Stanislav Chzhen <s.chzhen@adguard.com>
Date:   Fri Feb 10 13:35:51 2023 +0300

    Configuration: querylog stats ignore
Stanislav Chzhen 2023-02-13 18:36:05 +03:00
parent f17c333cd1
commit 9008939003

@ -359,7 +359,7 @@ Settings are stored in [YAML format](https://en.wikipedia.org/wiki/YAML), possib
- '0.0.0.0' - '0.0.0.0'
``` ```
- `port` — DNS server port to listen on. - `port` — DNS server port to listen on.
- `statistics_interval` — Time interval for statistics (in days) - `anonymize_client_ip` - If true, anonymize clients' IP addresses in logs and stats
- **Protection settings** - **Protection settings**
- `protection_enabled` — Whether any kind of filtering and protection should - `protection_enabled` — Whether any kind of filtering and protection should
be performed. **Since v0.107.0** it doesn't affect the rules with be performed. **Since v0.107.0** it doesn't affect the rules with
@ -377,14 +377,8 @@ Settings are stored in [YAML format](https://en.wikipedia.org/wiki/YAML), possib
- `safesearch_enabled` — Enforcing "Safe search" option for search engines, when possible. - `safesearch_enabled` — Enforcing "Safe search" option for search engines, when possible.
- `safebrowsing_enabled` — Filtering of DNS requests based on safebrowsing. - `safebrowsing_enabled` — Filtering of DNS requests based on safebrowsing.
- **Query log settings** - **Query log settings**
- `querylog_enabled` — Query logging (also used to calculate top 50 clients, blocked domains and requested domains for statistical purposes). - **Before v0.107.24** query log settings were part of the `dns` object.
- `querylog_file_enabled` — Write query logs to a file. **Since v0.107.24** query log settings are part of `querylog` object.
- `querylog_interval` - time interval for query log files rotation. It's in
days **until v0.107.0**, the possible values are: `90`, `30`, `7`, `1`.
**Since v0.107.0** it's a human-readable duration in hours, the possible
values are: `2160h`, `720h`, `168h`, `24h`, `6h`.
- `querylog_size_memory` - Number of entries kept in memory before they are flushed to disk
- `anonymize_client_ip` - If true, anonymize clients' IP addresses in logs and stats
- **Anti-DNS amplification features** - **Anti-DNS amplification features**
- `ratelimit` — DDoS protection, specifies in how many packets per second a client should receive. Anything above that is silently dropped. To disable set 0, default is 20. Safe to disable if DNS server is not available from internet. - `ratelimit` — DDoS protection, specifies in how many packets per second a client should receive. Anything above that is silently dropped. To disable set 0, default is 20. Safe to disable if DNS server is not available from internet.
- `ratelimit_whitelist` — If you want exclude some IP addresses from ratelimiting but keep ratelimiting on for others, put them here. - `ratelimit_whitelist` — If you want exclude some IP addresses from ratelimiting but keep ratelimiting on for others, put them here.
@ -501,6 +495,18 @@ Settings are stored in [YAML format](https://en.wikipedia.org/wiki/YAML), possib
DNS-over-HTTPS clients as well as for the web UI. DNS-over-HTTPS clients as well as for the web UI.
- `theme` (**since v0.107.22**): The theme of UI. The possible values are: - `theme` (**since v0.107.22**): The theme of UI. The possible values are:
`auto`, `dark`, `light`. `auto`, `dark`, `light`.
- `querylog` (**since v0.107.24**) — Query log settings section:
- `enabled`: Query log status.
- `file_enabled`: Write query logs to a file.
- `interval`: Time interval for query log files rotation. It's a
human-readable duration in hours, the possible values are: `2160h`,
`720h`, `168h`, `24h`, `6h`.
- `size_memory`: Number of entries kept in memory before they are flushed to disk.
- `ignored`: List of host names, which should not be written to log.
- `statistics` (**since v0.107.24**) — Statistics settings section:
- `enabled`: Statistics status.
- `interval`: Time interval for statistics (in days)
- `ignored`: List of host names, which should not be counted.
- `filters` — List of filters, each filter has the following values: - `filters` — List of filters, each filter has the following values:
- `enabled` — Current filter's status (enabled/disabled). - `enabled` — Current filter's status (enabled/disabled).
- `url` — URL pointing to the filter contents (filtering rules). - `url` — URL pointing to the filter contents (filtering rules).