NAME

check_networkspans - Check interfaces to see if we are getting span traffic.

SYNOPSIS

check_networkspans -s <span ports> [-s <span ports>] [-i <ignore IP>] [-a <0/1>] [-S <seconds>] [-p <packets>] [-P <port>] [-A <port>] [--debug]

check_networkspans -h/--help

check_networkspans -v/--version

DESCRIPTION

A nagios style check to see if a the specified spans are seeing traffic or not.

FLAGS, GENERAL

-a <0/1>

If the first IP on each interface, for all interfaces on the machine not just spans, should be ignored.

Default :: 1

-A <port>

Additional ports to look for. Will be appended to -P if used or other wise will be appended to the defaults.

-S <seconds>

Max time the test should run for in seconds.

Default :: 120

-i <ignore IP>

A IPv4 or IPv6 address to ignore.

May be used more than once.

-p <packets>

Number of packets to capture for the test. This is the number of total packets to capture across all interfaces of a span.

Default :: 5000

-P <port>

A port to check for. To specify more than one poart use -P mulitple times.

Default :: 22, 53, 80, 88, 135, 389, 443, 445, 3389, 3306, 5432

-s <span ports>

A comma seperated list of ports to look for traffic on.

May be used more than once.

If one of the items in the list starts with %, that will be used as the name of the span. It will not be used as a interface.

Starting and leading spaces and tabs for each interface is removed.

--debug

Enable debugging.

FLAGS, ALERT CONTROL

Levels are as below.

- 0 :: OK
- 1 :: WARNING
- 2 :: ALERT
- 3 :: ERROR

If you want to ignore a alert type entirely, set the level to 0.

-n <level>

No packets.

Default :: 2

-N <interface>

A interface to ignore for no packets.

My be specified multiple times for more than one.

Default :: undef

-l <level>

Low packets.

Default :: 1

-L <span>

A span or span name to ignore for low packets.

My be specified multiple times for more than one.

Default :: undef

-d <level>

No streams, meaning no bi directional traffic TCP/UDP between IPs found.

Default :: 2

-D <span>

A span name or span to ignore for no streams.

My be specified multiple times for more than one.

Default :: undef

-m <level>

Missing interface.

Default :: 2

-M <interface>

A interface to ignore for missing interface.

My be specified multiple times for more than one.

Default :: undef

-c <level>

Port check.

Default :: 1

-C <span>

A span or span name to ignore for port checks..

My be specified multiple times for more than one.

Default :: undef