From fa9cdda02dd5703b9af1548094b3947f5c0046ed Mon Sep 17 00:00:00 2001 From: DL6ER Date: Mon, 20 Aug 2018 11:52:28 +0200 Subject: [PATCH 1/4] Update privacy levels (new level 4) Signed-off-by: DL6ER --- docs/ftldns/configfile.md | 2 +- docs/ftldns/privacylevels.md | 7 +++++-- 2 files changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/ftldns/configfile.md b/docs/ftldns/configfile.md index 5316f9c..a8fadca 100644 --- a/docs/ftldns/configfile.md +++ b/docs/ftldns/configfile.md @@ -55,7 +55,7 @@ Up to how many hours of queries should be imported from the database and logs? M On which port should FTL be listening? ### PRIVACYLEVEL -`PRIVACYLEVEL=0|1|2|3` +`PRIVACYLEVEL=0|1|2|3|4` Which privacy level is used? diff --git a/docs/ftldns/privacylevels.md b/docs/ftldns/privacylevels.md index 82a47ce..716e956 100644 --- a/docs/ftldns/privacylevels.md +++ b/docs/ftldns/privacylevels.md @@ -23,8 +23,8 @@ This setting disables - Top Clients - Clients over time -### Level 3 - paranoia mode (hide everything) -Disabled basically everything except the most anonymous statistics +### Level 3 - paranoia mode (anonymize everything) +Disable all details except the most anonymous statistics This setting disables @@ -35,4 +35,7 @@ This setting disables - Query Log - Long-term database logging +### Level 4 - disabled statistics +Disables all statistics processing at all. Even the query counters will not be available. + {!abbreviations.md!} From 75977ac9fc0471e83efec4879121122f56e7d921 Mon Sep 17 00:00:00 2001 From: DL6ER Date: Mon, 20 Aug 2018 11:56:26 +0200 Subject: [PATCH 2/4] Add DBIMPORT=yes|no documentation Signed-off-by: DL6ER --- docs/ftldns/configfile.md | 7 +++++++ docs/ftldns/database.md | 2 ++ 2 files changed, 9 insertions(+) diff --git a/docs/ftldns/configfile.md b/docs/ftldns/configfile.md index a8fadca..5462b03 100644 --- a/docs/ftldns/configfile.md +++ b/docs/ftldns/configfile.md @@ -82,5 +82,12 @@ Controls if *FTL*DNS should print extended details about regex matching into `pi **[More details](regex/overview.md)** +### DBIMPORT +`DBIMPORT=yes|no` + +Should `FTL` load information from the database on startup to be aware of the most recent history? + +**[More details](database.md)** + {!abbreviations.md!} diff --git a/docs/ftldns/database.md b/docs/ftldns/database.md index 5379770..4c21efe 100644 --- a/docs/ftldns/database.md +++ b/docs/ftldns/database.md @@ -15,6 +15,8 @@ Note that DNS resolution will not be available as long as `pihole-FTL` is stoppe Another way of controlling the size of the long-term database is setting a maximum age for log queries to keep using the config parameter [`MAXDBDAYS`](configfile.md#maxdbdays). It defaults to 365 days, i.e. queries that are older than one year get periodically removed to limit the growth of the long-term database file. +The config parameter [`DBIMPORT`](configfile.md#dbimport) controls whether `FTL` loads information from the database on startup. It need to do this to populate the internal datastructure with the most recent history. However, as importing from the database on disk can delay FTL on very large deploys, it can be disabled using this option. + --- The long-term database contains three tables: From 08908d2330b29055c17240f8e8b3744a6deea2dd Mon Sep 17 00:00:00 2001 From: DL6ER Date: Mon, 20 Aug 2018 11:59:44 +0200 Subject: [PATCH 3/4] Add sentence that they probably want to disable file logging as well when looking up privacy level 4 Signed-off-by: DL6ER --- docs/ftldns/privacylevels.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/ftldns/privacylevels.md b/docs/ftldns/privacylevels.md index 716e956..e889cde 100644 --- a/docs/ftldns/privacylevels.md +++ b/docs/ftldns/privacylevels.md @@ -37,5 +37,6 @@ This setting disables ### Level 4 - disabled statistics Disables all statistics processing at all. Even the query counters will not be available. +Make sure you have disabled logging to the file `/var/log/pihole.log` using `sudo pihole logging off`. {!abbreviations.md!} From 76105430b37af3a30dc3bbf4aafc9f45a17809ec Mon Sep 17 00:00:00 2001 From: DL6ER Date: Mon, 20 Aug 2018 23:08:11 +0200 Subject: [PATCH 4/4] Review comments Signed-off-by: DL6ER --- docs/ftldns/privacylevels.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/ftldns/privacylevels.md b/docs/ftldns/privacylevels.md index e889cde..37184e3 100644 --- a/docs/ftldns/privacylevels.md +++ b/docs/ftldns/privacylevels.md @@ -23,7 +23,7 @@ This setting disables - Top Clients - Clients over time -### Level 3 - paranoia mode (anonymize everything) +### Level 3 - anonymous mode (anonymize everything) Disable all details except the most anonymous statistics This setting disables @@ -36,7 +36,7 @@ This setting disables - Long-term database logging ### Level 4 - disabled statistics -Disables all statistics processing at all. Even the query counters will not be available. -Make sure you have disabled logging to the file `/var/log/pihole.log` using `sudo pihole logging off`. +Disables all statistics processing. Even the query counters will not be available. +Additionally, you can disable logging to the file `/var/log/pihole.log` using `sudo pihole logging off`. {!abbreviations.md!}