Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: updated for opreports 3.x

Starting with version 2.34.opReports supports user-defined detail levels for the WAN reports, and this document briefly describes how to configure this feature.

...

To define your own detail level, open conf/opCommon.nmis (for opReports 3.X, or conf/opReports.nmis for opReports 2.x) in an editor and look for the block named ''report_wan_levels", which should look like this:

Code Block
themeEmacs
'report_wan_levels' => {
	'1' => {
 		"name"=>"Default",
		"description" => "The Default report contains a modest default level of details.",
		"extras" => "ResponseTime,InOutErrorDiscards,AvgMaxInOutBits",
 	},
 	'2' => {
 		"name"=>"Full Detail",
 		"description" => "The Full Detail report includes all known options.",
 		"extras" => "ResponseTime,InOutErrorDiscards,AvgMaxInOutBits,ErrPct,ErrExc,DiscPct,DiscExc,Util95,UtilExc",
 	},
},

Simply copy one of the default existing definition block blocks and paste it after just before the first last closing curly brace, then amend the level definition: First your custom detail level needs to be given an index number and name which define the order and entry text on the menu page. Second, the description text for all report levels will be shown in the right column on the menu page, so it should be kept short. Finally, the entry headed extras defines what extra columns are to be included in your report. Insert only option names from the table above and separate them by single commas. The order of columns in the report is fixed and how you order your extras is not relevant.

...

The three values above are given in percent and specify the thresholds for counting exceptions in terms of  packet errors, packet discards and interface utilisation percentages, respectively.

Your In opReports 2.x your new report detail levels will show up on the Reporting Option Menu page immediatly after you save the configuration file. To use these detail levels from the command line simply add the argument level=N to your invocation of opReports.pl, with N being the index of the desired detail level.

For opReports .nmis file3.x you need to restart the Opmantek Web Service (with sudo service omkd restart or similar) to see them in the report creation GUI; the command line tool opreports-cli.pl  uses the option report_wan_level=<name or number> to select the level.