NAME

Monitoring::Sneck::Checks::suricata_flows - checks Suricata is seeing bi directional flows, through Check::SuricataFlows

VERSION

Version 0.3.0

SYNOPSIS

suricata_flows|perl:suricata_flows
suricata_flows|perl:suricata_flows -f /var/log/suricata/flows/current/flow.json -a 20 -w 50
suricata_flows|perl:suricata_flows -s sensor1 -s sensor2 -i 192.0.2.1

DESCRIPTION

A Monitoring::Sneck::Checks check, for running Check::SuricataFlows in process from sneck, or through sneck_check. It is only of use if Monitoring::Sneck::Checks is installed, which this distribution does not require.

It takes the same options as check_suricataflows and works out the status the same way, see Check::SuricataFlows for how flows are read and counted. A flow file that is not there or can not be read is UNKNOWN.

The status line has the bi and uni directional counts, followed by the same lines check_suricataflows prints. Perfdata is the bi and uni directional counts, and the bi directional count of each sensor given with -s, as bi_$sensor.

OPTIONS

- -f <flows.json> :: The flow EVE JSON file. Default :: /var/log/suricata/flows/current/flow.json

- -a <alert count> :: CRITICAL if the bi directional count is this or under. Default :: 10

- -w <warn count> :: WARNING if the bi directional count is this or under. Default :: 20

- -t <seconds> :: How far back to read, in seconds. Default :: 300

- -m <max lines> :: The most lines to read. Default :: 500

- -s <sensor> :: A sensor name, from .host, to check for. May be given more than once.

- -i <IP> :: A IP whose flows are ignored, as source or destination. May be given more than once.

-t is --timeout for every sneck check, so for this one --timeout is the same as -t. It is used only as how far back to read, as nothing is waited on over the network.

METHODS

check

Does the check.

AUTHOR

Zane C. Bowers-Hadley, <vvelox at vvelox.net>

LICENSE AND COPYRIGHT

This software is Copyright (c) 2026 by Zane C. Bowers-Hadley.

This is free software, licensed under:

The GNU General Public License, Version 2, June 1991