WhenRepeatedFilter - Log after timeout

[snakefoot]

Attempt to resolve #2295

Added new property IncludeFirst=true/false (default=false), that controls whether it applies the configured action to the initial logevent.

When IncludeFirst=true then the initial logevent will start a timeout-period (but without it being logged), so only when the timeout-period expires then the first logevent is logged.

[codecov]

Codecov Report

Merging #2297 into master will increase coverage by <1%.
The diff coverage is 96%.

@@           Coverage Diff           @@
##           master   #2297    +/-   ##
=======================================
+ Coverage      82%     82%   +<1%     
=======================================
  Files         304     304            
  Lines       21414   21429    +15     
  Branches     2579    2581     +2     
=======================================
+ Hits        17517   17547    +30     
+ Misses       3229    3227     -2     
+ Partials      668     655    -13

[304NotModified]

How does this resolve #2295?

[snakefoot]

whenRepeated action="ignore" means first logevent is logged, and ignores everything else until timeout expires, where it logs again.

whenRepeated action="log" means first logevent is ignored, and also ignores everything else until timeout expires, where it logs first time.

[snakefoot]

Could also consider not abusing the Action-property. But just introduce a new property called IncludeFirst=true/false (default=false), where it also applies the action to the initial event starting the timeout-period.

[Mykezero]

Hi @snakefoot, this is exactly the functionality I was looking for!

[304NotModified]

OK great! great work @snakefoot !

[snakefoot]

Updated documentation:

https://github.com/NLog/NLog/wiki/WhenRepeated-Filter