https://github.com/eclecticlogic/whisper
Logback and Log4j v2 appender that suppresses messages of the same kind when they exceed a defined frequency and sends out a periodic digest of such suppressed messages.
https://github.com/eclecticlogic/whisper
digest java logback slf4j suppression
Last synced: about 2 months ago
JSON representation
Logback and Log4j v2 appender that suppresses messages of the same kind when they exceed a defined frequency and sends out a periodic digest of such suppressed messages.
- Host: GitHub
- URL: https://github.com/eclecticlogic/whisper
- Owner: eclecticlogic
- License: apache-2.0
- Created: 2013-12-12T12:39:07.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2022-02-18T00:45:40.000Z (about 4 years ago)
- Last Synced: 2025-12-20T13:58:46.056Z (4 months ago)
- Topics: digest, java, logback, slf4j, suppression
- Language: Java
- Homepage: http://www.eclecticlogic.com/whisper
- Size: 212 KB
- Stars: 31
- Watchers: 4
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# What is Whisper?
Have you ever had something go wrong in your production server and had your Logback email appender immediately send you an email alert? You probably felt like a DevOps guru because you knew exactly what caused the error before anyone else. But then you realize that you've got a database issue and every user request from the app results in an error email (possibly more than one). Right at that time a backend process launches and tries to connect to the database and all hell breaks loose because your email server is now straining under the error email deluge - all 50,000 of them saying the same thing - some variation of "could not connect to database"!
Perhaps you weren't so fortunate to see this happen in real-time. Perhaps the first time you noticed it was when you got back into work and saw the 50,000 new emails awaiting your attention. And as you sit and delete page after page of email, you have this suspicion that perhaps somewhere in those 50,000 emails (all looking alike) there is a one-off error email that may be important and you are going to accidentally delete it.
Whisper is your solution to controlling error email spam. Whisper acts as a pass through appender to your default SMTP appender for emails.
When the frequency of a message exceeds the configured threshold, Whisper starts to suppress it. While suppression is on, Whisper will even send you periodic digests letting you know which messages were suppressed and how many of them were suppressed. When things gets resolved and your error message frequency drops, suppression is stopped and things resume as normal. All of this happens on a per log message basis (not including the timestamp and factoring away parameters if you used the parameterized SLF4j log format).
### What Logging frameworks does Whisper support?
Whisper currently supports Logback. We hope to add support for log4j and log4jv2 in the future.
### How do I get the JAR?
Whisper is available via Maven Central repo.
```
com.eclecticlogic
whisper
jar
1.0.4
```
### How do I configure Whisper?
You can refer to the whisper-logback-sample.xml under src/sample/resources. Here is the gist of how to configure Whisper for use with Logback to
handle the most common case of suppressing ERROR messages that are sent via the email appender.
To configure the Whisper appender, first you must configure two other appenders - the regular email appender for ERROR level logs and a second
email appender for sending the suppression Digests when suppression is actually in effect.
```
ERROR
ACCEPT
DENY
ADDRESS-OF-YOUR-SMTP-HOST
EMAIL-DESTINATION
SENDER-EMAIL
TESTING: %logger{20} - %m
%date %-5level %logger{35} - %message%n
ADDRESS-OF-YOUR-SMTP-HOST
EMAIL-DESTINATION
SENDER-EMAIL
%X{whisper.digest.subject}
%date %-5level %logger{35} - %message%n
```
Note the use of `%X{whisper.digest.subject}` for the subject of the digest appender.
We now configure the Whisper appender as shown below:
```
ERROR
ACCEPT
DENY
digest.appender.logger
3 in 5 minutes
4 minutes
20 minutes
```
The digest logger name is then associated with the digestAppender and the whisper appender is included in the
list of default appenders:
```
```
### What is the license?
Good old [Apache License](http://apache.org/licenses/LICENSE-2.0.html).
# Release Notes
### v1.0.4
- Fixed [bug](https://github.com/eclecticlogic/whisper/issues/6) caused when the log message itself is null.
### v1.0.3
- Fixed [bug](https://github.com/eclecticlogic/whisper/issues/4) that leaves Muffler in the map
### v1.0.2
- Fixed issue causing digest to continue to report no suppression as described [here](https://github.com/eclecticlogic/whisper/issues/3).
### v1.0.1
- Fixed issue (NPE on digest run) described [here](https://github.com/eclecticlogic/whisper/issues/1).