Add documentation for the new data-dependent additonal_info field

Signed-off-by: DL6ER <dl6er@dl6er.de>
This commit is contained in:
DL6ER
2020-08-16 14:58:42 +02:00
parent 4e3a72e1c0
commit 89d80bf87e
+17
View File
@@ -49,6 +49,23 @@ Label | Type | Allowed to by empty | Content
`domain` | text | No | Requested domain
`client` | text | No | Requesting client (IP address)
`forward` | text | Yes | Forward destination used for this query (only set if `status == 2`)
`additional_info` | blob | Yes | Data-dependent content, see below
#### Data-dependent `additional_info` field
The content and type of the `additional_info` row depends on the status of the given query.
##### Query blocked due to a CNAME inspection (status 9, 10, 11) {#additional_info_cname data-toc-label='Blocked CNAME'}
If a query was blocked due to a CNAME inspection (status 9, 10, 11), this field contains the domain which was the reason for blocking the entire CNAME chain (text).
##### Query blocked due to a REGEX filter (status 4) {#additional_info_regex data-toc-label='Regular expression'}
If a query was blocked due to a regex rule (status 4), this field contains the ID of the blacklist regex responsible for blocking this domain (integer).
##### Other
For any other query status, this field is empty. You should, however, not rely on this field being empty as we may add content of any type for other status types in future releases.
### Counters table