Changing Parameters

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 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. Specifying `0' as the value for a top-report will cause all data to get displayed.

Caution

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, referring to your page, the page containing the link will be mentioned 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.