Many subreports (and filters) can be customized through the configuration files. For example, consider this excerpt from the DNS configuration file previously listed.
top-requesting-hosts hosts_to_show=10 top-requested-names names_to_show=10 requesttype-distribution requests-by-period period=1d
All the reports are selected, but furthermore, for the subreports giving a "Top X" output the number X can be defined. With the above configuration the report top-requesting-hosts will give a Top 10.
All variable settings must be placed on the same line as the subreport's id or filter's id!
A more exotic example is taken from the WWW superservice configuration file:
top-referers-by-page referer_to_show=5 page_to_show=10 referer_exclusion='^-$'
In this example a Perl regular expression is used as content for the referer_exclusion variable. This expression matches all referers -. Such referers are found in the log file in cases when e.g. the URL of your web page was typed by the client user. (When users visit your page by clicking on a link in a page, refering to your page, the page linked from will be given in the referer field.) All referers that match - will be excluded from the analysis.
In Part II, you will find the description of all the available subreports along with their parameters.