ErrorCollector Logback-classic 
This projects aims to provide a convenient way to be notified if an error in on of your systems occurs.
The appender will collect all errors in a configurable interval (default 5 min).
If exception occurred will send them to the configured publisher(Microsoft Teams and Telegram are currently supported)
Gradle
kotlinscript:
repositories{
mavenCentral()
}
dependencies{
implementation("net.mayope:errorcollector:x.x.x")
}
groovy:
repositories{
mavenCentral()
}
dependencies{
implementation 'net.mayope:errorcollector:x.x.x'
}
Maven
<dependency>
<groupId>net.mayopegroupId>
<artifactId>errorcollectorartifactId>
<version>0.0.7version>
dependency>
Usage Telegram
Example Logback configuration
xml version="1.0" encoding="UTF-8"?>
<configuration>
<appender name="errorAppender" class="net.mayope.errorcollector.TelegramAppender">
<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
<level>ERRORlevel>
filter>
<url>https://api.telegram.orgurl>
<chatId>-5514719561chatId>
<botToken>1711031898:AAEtyASDJwnl73or02KLttD3zPlWWIPuxVsbotToken>
<urlPastebin>https://my.deployed.pastebinurlPastebin>
<pastebinUsername>usernamepastebinUsername>
<pastebinPassword>passwordpastebinPassword>
<blacklist>exception1;exception2blacklist>
<connectTimeOut>60connectTimeOut>
<readTimeOut>600readTimeOut>
<issueProvider>githubissueProvider>
<issueBaseUrl>https://github.com/mayope/errorcollector/issues/newissueBaseUrl>
<sendIntervalMinutes>https://github.com/mayope/errorcollector/issues/newsendIntervalMinutes>
<serviceName>myCoolServiceserviceName>
<activateOnEnv>PRODUCTIONactivateOnEnv>
appender>
<root level="ERROR">
<appender-ref ref="errorAppender"/>
root>
configuration>
Parameter
-
url: String, optional, default = "https://api.telegram.org"
-
chatId: String, required
-
botToken: String, required
-
connectTimeOut: Long, optional, default = 60ms
-
readTimeOut: Long, optional, default = 600ms
-
urlPastebin: String?, optional, default = null
| this can be used to post stacktraces to a pastebin. In the message will then appear a link to the pastebin for this stacktrace
-
pastebinUsername: String?, optional, default = null
-
pastebinPassword: String?, optional, default = null
| This parameters can be used for basic authentication against the configured pastebin
-
blacklist: String = "", optional, default = null
| Will split all strings in this parameter by
;and if an exception contains any of this strings, it will be dropped -
issueProvider: String?, optional, default = null, possible values=
jira,github| this parameter can be used to create an issue create link in the message
-
issueBaseUrl: String?, optional, default = null
-
sendIntervalMinutes: Long, optional, default = 5
-
serviceName: String?, optional, default = Environment variable
HOSTNAMEor if this is also null"" -
activateOnEnv: String?, optional ,default = null
| Only enable error sending if this environment variable is set to any value
Usage Teams
Example Logback Configuration
xml version="1.0" encoding="UTF-8"?>
<configuration>
<appender name="teamsAppender" class="net.mayope.errorcollector.TeamsAppender">
<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
<level>ERRORlevel>
filter>
<webhookUrl>https://outlook.office.com/webhook/456654612321651webhookUrl>
<urlPastebin>https://my.deployed.pastebinurlPastebin>
<pastebinUsername>usernamepastebinUsername>
<pastebinPassword>passwordpastebinPassword>
<blacklist>exception1;exception2blacklist>
<connectTimeOut>60connectTimeOut>
<readTimeOut>600readTimeOut>
<issueProvider>githubissueProvider>
<issueBaseUrl>https://github.com/mayope/errorcollector/issues/newissueBaseUrl>
<sendIntervalMinutes>https://github.com/mayope/errorcollector/issues/newsendIntervalMinutes>
<serviceName>myCoolServiceserviceName>
<activateOnEnv>PRODUCTIONactivateOnEnv>
appender>
<include resource="org/springframework/boot/logging/logback/base.xml"/>
<logger name="org.springframework" level="INFO"/>
<root level="ERROR">
<appender-ref ref="teamsAppender"/>
root>
configuration>
Parameter
- webhookUrl: String, required
Following parameters are the same as for the Telegram Appender
15 Dec 4, 2022
6 Jul 17, 2022
6 Dec 1, 2022
2 Oct 5, 2022
3.4k Dec 29, 2022
7 Jun 12, 2022
1 Feb 11, 2022
0 Dec 29, 2021
222 Dec 1, 2022
45 Dec 19, 2022
15 Aug 28, 2022
137 Jan 3, 2023
2.6k Jan 9, 2023
376 Dec 21, 2022
237 Dec 29, 2022
36 Dec 13, 2022
241 Nov 11, 2022
5 Dec 3, 2022
12 Dec 16, 2022
4 Dec 12, 2021
0 Dec 25, 2021
0 Jan 18, 2022
2k Jan 1, 2023
21 Jul 14, 2022
1 May 22, 2022
15 Nov 16, 2022
12 Dec 25, 2022
2 Jan 7, 2022