DragonFly On-Line Manual Pages
rwguess(8) SiLK Tool Suite rwguess(8)
NAME
rwguess - Determine which SNMP interfaces are active
SYNOPSIS
rwguess [{ --top=NUM | --print-all }] PDU_FILE [PDU_FILE...]
rwguess --help
rwguess --version
DESCRIPTION
rwguess is deprecated as of SiLK 3.8.3 and it will be removed in the
SiLK 4.0 release. Replace invocations of rwguess with rrwwppdduu22ssiillkk(1)
and either rrwwssttaattss(1) or rrwwuunniiqq(1) as shown in "EXAMPLES".
rwguess reads NetFlow v5 PDUs from file(s) specified on the command
line and counts the number of flow records that are seen on each input
and output SNMP interface. Once all input has been processed, rwguess
sorts the SNMP interfaces by the number of records each interface saw,
and prints the two sorted lists, one for the input interfaces and one
for the output interfaces. By default, only the top-10 interfaces are
printed; the number of rows printed may be changed with the --top
switch.
When the --print-all switch is specified, the results are printed in
SNMP interface order, with one column for the input record count and
another for the output record count, and one row for each interface
that saw traffic.
The purpose of rwguess is to help one configure the "sensor" blocks in
the ssiillkk..ccoonnff(5) file used by rrwwfflloowwppaacckk(8) to categorize flow records
into classes and types.
The PDU files are expected to be in the form created by NetFlow
Collector: Each file's size must be an integer multiple of 1464, where
each 1464 byte chunk contains a 24 byte NetFlow v5 header and space for
thirty 48 byte NetFlow records. The number of valid records per chunk
is specified in the PDU header.
To convert a PDU file to a stream of SiLK Flow records, use
rrwwppdduu22ssiillkk(1).
OPTIONS
Option names may be abbreviated if the abbreviation is unique or is an
exact match for an option. A parameter to an option may be specified
as --arg=param or --arg param, though the first form is required for
options that take optional parameters.
--top=NUM
Print the top NUM interfaces for each of input and output. If not
specified, the default is to print the top 10 interfaces.
--print-all
Print all SNMP interfaces that saw records, sorted by the SNMP
interface number. This switch disables top-N printing.
--help
Print the available options and exit.
--version
Print the version number and information about how SiLK was
configured, then exit the application.
EXAMPLES
rwguess is deprecated. This section demonstrates how to get equivalent
functionality by piping the output from rrwwppdduu22ssiillkk(1) into either
rrwwssttaattss(1) or rrwwuunniiqq(1).
In the following examples, the dollar sign ("$") represents the shell
prompt. The text after the dollar sign represents the command line.
Lines have been wrapped for improved readability, and the back slash
("\") is used to indicate a wrapped line.
Top-N List
By default, rwguess creates a top-10 list of SNMP interfaces.
$ rwguess file.pdu
Top 10 (of 36) SNMP Input Interfaces
Index| Input_Recs|
54| 3466|
38| 1374|
84| 770|
88| 746|
56| 737|
68| 513|
106| 508|
62| 373|
114| 323|
8| 321|
Top 10 (of 37) SNMP Output Interfaces
Index| Output_Recs|
54| 3507|
38| 885|
98| 699|
84| 673|
88| 671|
56| 605|
58| 538|
106| 501|
92| 460|
62| 380|
Use rwpdu2silk to convert the file to SiLK flow format, and pipe the
result to rwstats. You must invoke rwstats twice, once the input
interface (--field=in) and once for the output interface (--field=out).
The --copy-input switch allows the second rwstats command to read
output from rwpdu2silk.
$ rwpdu2silk file.pdu \
| rwstats --count=10 --fields=in --copy-input=- --output-path=stderr \
| rwstats --count=10 --fields=out
INPUT: 12056 Records for 36 Bins and 12056 Total Records
OUTPUT: Top 10 Bins by Records
in| Records| %Records| cumul_%|
54| 3466| 28.750663| 28.750663|
38| 1374| 11.398869| 40.149532|
84| 770| 6.388336| 46.537868|
88| 746| 6.193106| 52.730975|
56| 737| 6.117718| 58.848693|
68| 513| 4.261379| 63.110072|
106| 508| 4.216760| 67.326831|
62| 373| 3.094729| 70.421560|
114| 323| 2.681877| 73.103437|
8| 321| 2.666285| 75.769722|
INPUT: 12056 Records for 37 Bins and 12056 Total Records
OUTPUT: Top 10 Bins by Records
out| Records| %Records| cumul_%|
54| 3507| 29.089205| 29.089205|
38| 885| 7.347980| 36.437185|
98| 699| 5.801735| 42.238920|
84| 673| 5.588923| 47.827843|
88| 671| 5.572502| 53.400345|
56| 605| 5.022807| 58.423152|
58| 538| 4.462497| 62.885649|
106| 501| 4.155802| 67.041451|
92| 460| 3.821822| 70.863273|
62| 380| 3.157428| 74.020701|
Seeing all interfaces
The --print-all switch shows all interfaces.
$ rwguess --print-all file2.pdu
Index| Input_Recs| Output_Recs|
10| 17099| 17115|
172| 7893| 7893|
192| 25008| 24992|
Use rwuniq to generate similar output, though you must run rwuniq twice
(as with rwstats in the previous example).
$ rwpdu2silk file2.pdu \
| rwuniq --sort --fields=in --copy-input=- --output-path=stderr \
| rwuniq --sort --fields=out
in| Records|
10| 17099|
172| 7893|
192| 25008|
out| Records|
10| 17115|
172| 7893|
192| 24992|
SEE ALSO
rrwwppdduu22ssiillkk(1), rrwwssttaattss(1), rrwwuunniiqq(1), rrwwfflloowwppaacckk(8), sseennssoorr..ccoonnff(5),
ssiillkk(7)
SiLK 3.11.0.1 2016-02-19 rwguess(8)