hist_net_test(1)

NAME

hist_net_test - Calculate a histogram from the net performance weekly data files

SYNOPSIS

hist_net_test  [Option [...]] DataRoot {HistFile, -} SrcHost DestHost

DESCRIPTION

The script hist_net_test calculates a histogram from net performance weekly data files. The histogram will be calculated for the connection from SrcHost to DestHost. Both hosts may be specified with the host titles or (IP) addresses. The connection between both hosts may be one-directional or two-directional. The histograms can be calculated for the throughput values and for the minimum, average, maximum or lost round-trip values. It is also possible to add a previously obtained histogram file to the histogram to be calculated.

Th histogram can be calculated as a function from the following attributes:

The histogram output file, HistFile, is in the format of a gnuplot(1) data file. Therefore, it contains the following fields:

BinMean  BinCount  BinWidth

OPTIONS

The following options can be specified:

-add_hist {HistFile, -}
Add the histogram data from the histogram file HistFile or from Standard Input to the histogram to be calculated. This option may be multiple specified.

-bin_size BinSize
Set the bin size.
The default is: 1.

-hour MinHour[-MaxHour]
Set the hour of the day interval. This option may be multiple specified. Default all hours are added to the histogram.

-net_type {Inet, QoS}
Specify the net type. The default is: Inet.

-no_perc
Do not print percentages but bin counts. The default is to print bin counts.

-no_print
Do not print the values to be added to the histogram bins. This is the default.

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

-perc
Do not print percentages but bin counts.
This is the default.

-ping_type {min, avg, max, lost}
Specify the ping type. The default is: avg.

-print
Print the values to be added to the histogram bins to Standard Error in the format:

Date  WeekDay  Hour  Value  SrcHost  DestHost

Default the values are not printed.

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

-test_type {ping, throughput}
Set the test type to determine the histogram from. The default test type is: throughput.

-threshold Threshold
Set the threshold for a bin count to be accepted. The default is: 0.

-week MinWeek[-MaxWeek]
Set the week interval. This option may be multiple specified. Default all available weeks are added to the histogram.

-week_day MinWeekDay[-MaxWeekDay]
Set the day of the week ([0-6]) interval. This option may be multiple specified. Default all available weeks are added to the histogram.

SEE ALSO

event_net_test(1), gnuplot(1), list_net_test_weeks(1), mean_time_net_test(1)