https://github.com/teragrep/rlp_07
Teragrep RELP syslog to standard output server application
https://github.com/teragrep/rlp_07
java relp relp-server syslog-server teragrep
Last synced: about 2 months ago
JSON representation
Teragrep RELP syslog to standard output server application
- Host: GitHub
- URL: https://github.com/teragrep/rlp_07
- Owner: teragrep
- License: apache-2.0
- Created: 2022-07-22T09:19:17.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2025-04-07T13:35:39.000Z (about 1 year ago)
- Last Synced: 2025-04-22T12:11:58.939Z (about 1 year ago)
- Topics: java, relp, relp-server, syslog-server, teragrep
- Language: Java
- Homepage: https://teragrep.com
- Size: 39.1 KB
- Stars: 0
- Watchers: 2
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.adoc
- License: LICENSE
Awesome Lists containing this project
README
= Example RELP Server
Build with
[source, bash]
----
mvn clean package
----
Run with
[source, bash]
----
java -jar rlp_07.jar
----
Listens to plain server port 1601 by default and prints received events.
Port can be changed with "-Dport=1234" command-line argument.
TLS mode can be enabled with "-Dtls=true" command-line argument.
Custom server keystore can be supplied with "-DtlsKeystore=path/to/file.jks".
Custom server keystore password can be supplied with "-DtlsKeystorePassword=MyCustomPassword".
Internal component logging levels can be managed with "-Dloglevel=INFO". You can read more about logging levels https://logging.apache.org/log4j/2.x/manual/customloglevels.html[here].
[source, bash]
----
java -Dlog4j.configurationFile=log4j2.xml -jar rlp_07.jar
----
== Running the container
You can run the prebuilt container by simply running:
`docker run -ti --rm ghcr.io/teragrep/rlp_07/app:latest`
The container respects the following environment variables
[cols]
|===
|Environment variable|Property equivalent
|RLP_07_PORT=1243
|-Dport=1234
|RLP_07_TLS=false
|-Dtls=false
|RLP_07_TLS_KEYSTORE=/keystore.jks
|-DtlsKeystore=/keystore.jks
|RLP_07_TLS_KEYSTOREPASSWORD=changeit
|-DtlsKeystorePassword=changeit
|RLP_07_LOGLEVEL=INFO
|-Dloglevel=INFO
|===
== Contributing
// Change the repository name in the issues link to match with your project's name
You can involve yourself with our project by https://github.com/teragrep/rlp_07/issues/new/choose[opening an issue] or submitting a pull request.
Contribution requirements:
. *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.
. Security checks must pass
. Pull requests must align with the principles and http://www.extremeprogramming.org/values.html[values] of extreme programming.
. Pull requests must follow the principles of Object Thinking and Elegant Objects (EO).
Read more in our https://github.com/teragrep/teragrep/blob/main/contributing.adoc[Contributing Guideline].
=== Contributor License Agreement
Contributors must sign https://github.com/teragrep/teragrep/blob/main/cla.adoc[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.