1..::lib::Smokeping::matchers::C.o.n:s:elcSiumbto:ik:veSePmLioonksgesp(i3n)g::matchers::ConsecutiveLoss(3)
2
3
4

NAME

6       Smokeping::matchers::ConsecutiveLoss - Raise/clear alerts according to
7       your choice of threshold and consecutive values
8

DESCRIPTION

10       Use this matcher to raise and clear alerts according to your choice of
11       threshold and consecutive values.  As an example, you can raise an
12       alert on first occurrence of 50% packet loss, but choose to hold the
13       alert active until packet loss stays below 10% for 5 consecutive
14       measurements.
15
16       Add the matcher to your config file using below syntax:
17
18        type = matcher
19        edgetrigger = yes
20        pattern =  ConsecutiveLoss(pctlossraise=>##,stepsraise=>##,pctlossclear=>##,stepsclear=>##)
21
22       Replace the ## with integers of your choice, see below for reference:
23
24       pctlossraise - Loss values at or above this percentage will raise an
25       alert when...  stepsraise - ... number of consecutive values have been
26       collected
27
28       pctlossclear - Loss values below this percentage will clear an alert
29       when...  stepsclear - ... number of consecutive values have been
30       collected
31
32       In my environment, I define four alerts for levels like:
33
34        +packetloss_significant_instantalert
35        type = matcher
36        pattern = ConsecutiveLoss(pctlossraise=>10,stepsraise=>1,pctlossclear=>3,stepsclear=>3)
37        comment = Instant alert - Significant packet loss detected (At least 10% over 1 cycle). Alert will clear when loss stays at max 2% for 3 cycles
38        priority = 30
39
40        +packetloss_major_instantalert
41        type = matcher
42        pattern = ConsecutiveLoss(pctlossraise=>25,stepsraise=>1,pctlossclear=>3,stepsclear=>3)
43        comment = Instant alert - Major packet loss detected (At least 25% over 1 cycle). Alert will clear when loss stays at max 2% for 3 cycles
44        priority = 20
45
46        +packetloss_significant_consecutivealert
47        type = matcher
48        pattern = ConsecutiveLoss(pctlossraise=>10,stepsraise=>3,pctlossclear=>3,stepsclear=>5)
49        comment = Consecutive occurrence of significant packet loss detected (At least 10% over 3 cycles). Alert will clear when loss stays at max 2% for 5 cycles.
50        priority = 10
51
52        +packetloss_major_consecutivealert
53        type = matcher
54        pattern = ConsecutiveLoss(pctlossraise=>25,stepsraise=>3,pctlossclear=>3,stepsclear=>5)
55        comment = Consecutive occurrence of significant packet loss detected (At least 25% over 3 cycles). Alert will clear when loss stays at max 2% for 5 cycles.
56        priority = 5
57
59       Copyright (c) 2017 Rickard Borgmaster
60

LICENSE

62       This program is free software; you can redistribute it and/or modify it
63       under the terms of the GNU General Public License as published by the
64       Free Software Foundation; either version 2 of the License, or (at your
65       option) any later version.
66
67       This program is distributed in the hope that it will be useful, but
68       WITHOUT ANY WARRANTY; without even the implied warranty of
69       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
70       General Public License for more details.
71
72       You should have received a copy of the GNU General Public License along
73       with this program; if not, write to the Free Software Foundation, Inc.,
74       675 Mass Ave, Cambridge, MA 02139, USA.
75

AUTHOR

77       Rickard Borgmaster. 2017.  Based on the CheckLoss/Checklatency matchers
78       by Dylan Vanderhoof 2006.
79
80
81
822.8.2                         ..::2l0i2b3:-:0S1m-o2k1eping::matchers::ConsecutiveLoss(3)
Impressum