bogus_log: document new function frequent()

diff --git a/modules/bogus_log/README.rst b/modules/bogus_log/README.rst
index dc42ba01acb39667344ea789524c11fcc7fb023d..0b93e82b4fe3a1a13d72e52806b0767a04fec5e1 100644 (file)
--- a/modules/bogus_log/README.rst
+++ b/modules/bogus_log/README.rst
@@ -21,5 +21,21 @@ Example of error message logged by this module:
 
 .. _DNSViz: http://dnsviz.net/
 
+List of most frequent queries which fail as DNSSEC bogus can be obtained at run-time:
+
+.. code-block:: lua
+
+      > bogus_log.frequent()
+      [1] => {
+          [type] => DNSKEY
+          [count] => 1
+          [name] => dnssec-failed.org.
+      }
+      [2] => {
+          [type] => DNSKEY
+          [count] => 13
+          [name] => rhybar.cz.
+      }
+
 Please note that in future this module might be replaced
 with some other way to log this information.