event_net_test(1)

NAME

event_net_test - List net performance events specified by Perl regular expressions from selected weekly data files

SYNOPSIS

event_net_test  [Option [...] DataRoot {OutputFile, -} EventRE [...]

DESCRIPTION

The script event_net_test lists net performance events specified by perl(1) regular expressions, perlre(1). These expressions may contain the Perl variables $ping_min, $ping_avg, $ping_max, $ping_lost and $tput which are containing the momentary values of the corresponding net performance parameters. All specified EventRE regular expressions are AND'ed.

OPTIONS

The following options can be specified:

-add_event EventFile
Add the event data from the corresponding EventFile or from the corresponding Standard Input after the events to be determined. The events are sorted to increasing history. This option may be multiple specified. See also the -event option.

-conn SrcHost/DestHost
Print only the events for the connections specified with this option. It may be multiple specified. When symmetric connections are used (option -symm_conn) also the reverse connection is checked. Print the events for all connections when this option is not specified.

-event EventFile
Write the event data to file such that they can be added to another version of this script. See the -add_event option.

-force
Force to continue after some non-fatal errors such as format errors in an event file to add (option -add_event). Default do not continue after these errors.

-no_force
Do not force to continue after some non-fatal errors. This is the default.

-no_symm_conn
Use the connection between both hosts not symmetric (i.e. in one direction. This is the default.

-skip_host Host
Skip the events from the specified host. This option may be multiple specified.

-symm_conn
Use the connection between both hosts symmetric (i.e. in two directions). Default there is not a symmetric connection.

-week MinWeek[-MaxWeek]
Set the week interval. This option may be multiple specified. Default the events for all available weeks are listed.

EXAMPLE

In the following example the net monitor data are listed to Standard Output for which the throughput values are smaller than 0.5 Mbit/s.

% event_net_test Data - '$tput < 0.5'

SEE ALSO

hist_net_test(1), list_net_test_weeks(1), mean_time_net_test(1), perl(1), perlre(1)