Relp Logging plugin for Logback

See logback.example.xml for example config

Parameters

Parameter	Description
relpHostAddress	Connection destination address
relpPort	Connection destination port
enableEventId48577	Enables structured data containing uuid and source information
appName	Stream application identifier. Maximum length of 48 characters, limited by RFC5424
hostname	Stream host identifier. Maximum length of 255 characters, limited by RFC5424
connectionTimeout	Time to wait before timing out connection
reconnectInterval	Time to wait between re-connection attempts
writeTimeout	Time to wait for destination to accept data
readTimeout	Time to wait for destination to acknowledge sent data (low values cause duplicates)
keepAlive	Enables sending alive packets. Default true.
reconnectIfNoMessagesInterval	Reconnects before sending message if at least X milliseconds have passed since last message. Default 150000, set to 0 to turn off automatic reconnections.

jboss-module

These instructions are untested but should work none the less. jla_01-1.0.5-jboss-modules.jar contains logback appender for jboss as jboss-module. For generic information about jboss modules, see https://jboss-modules.github.io/jboss-modules/manual/

Inclusion

Copy the jar into $EAP_HOME/modules.

Include module by using following convetion to target module.xml (which may be quite many).

<?xml version="1.0" encoding="UTF-8"?>
<module ...>
<.../>
<dependencies>
<module name="com.teragrep.jla_01"/>
</dependencies>
<.../>
</module>

One may wish to add this as a global module according to following link in order to avoid multiple inclusions: https://access.redhat.com/documentation/en-us/red_hat_jboss_enterprise_application_platform/7.0/html-single/configuration_guide/index#add_a_global_module

Configuring pre-built Logback application

First download wanted versions of jla_01, rlp_01, tls_01 and rlo_14 from the following urls:

• jla_01

• rlp_01

• tls_01

• rlo_14

Then run java while pointing classpath to the directory where you downloaded the jars to like:

java -cp "path/to/downloaded/jars/*:target/example.jar" com.teragrep.example.Main

Contributing

You can involve yourself with our project by opening an issue or submitting a pull request.

Contribution requirements:

1. All changes must be accompanied by a new or changed test. If you think testing is not required in your pull request, include a sufficient explanation as why you think so.

2. Security checks must pass

3. Pull requests must align with the principles and values of extreme programming.

4. Pull requests must follow the principles of Object Thinking and Elegant Objects (EO).

Read more in our Contributing Guideline.

Contributor License Agreement

Contributors must sign Teragrep Contributor License Agreement before a pull request is accepted to organization’s repositories.

You need to submit the CLA only once. After submitting the CLA you can contribute to all Teragrep’s repositories.