Skip to content

Commit

Permalink
Update README.adoc
Browse files Browse the repository at this point in the history
added contributing guideline
  • Loading branch information
ronja-ui authored Jan 9, 2024
1 parent 6f8c6c0 commit f1ac8e8
Showing 1 changed file with 35 additions and 11 deletions.
46 changes: 35 additions & 11 deletions README.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,13 @@

Create appender for log4js-node to enable RELP usage from node.js applications.


User Story:
As a developer I would like to use jsa_01 to push log messages over relp to a compatible relp-server with syslog envelope

== Specs

^^^^^
Requirements Backlog

[options="header,footer"]
|=======================
|# |Title |User Story |Importance |Status
Expand All @@ -31,19 +30,21 @@ Requirements Backlog

|=======================



== High-level Architecture

image::https://github.com/teragrep/jsa_01/blob/base-feat/images/JSA_01.png[]

== Implementation

The jsAppender to push log messages over relp to a compatible relp-server with syslog envelope.
For the
RELP connection - rlp_02 +
Generate the Syslog message - rlo_08 +
RELP compatible server - Java-relp-server-demo (tested on)

Use following components for:

* rlp_02: RELP connection
* rlo_08: Generate the Syslog message
* Java-relp-server-demo: RELP compatible server (tested on)

How to implement:

* asynchronus behaviour completely controlled by the Jasmine async works.
+
Expand All @@ -53,7 +54,9 @@ npm install
-----------------

* Module usage:
+ The appender uses the rlo_08 for handling formatting log messages and rlp_02 to send the log event message to the RELP Server.
+
The appender uses the rlo_08 for handling formatting log messages and rlp_02 to send the log event message to the RELP Server.
+
[source,javascript]
-----------------
const { SyslogMessage, Facility, SDElement, SDParam, Severity } = require('@teragrep/rlo_08')
Expand All @@ -67,8 +70,8 @@ const { RelpConnection, RelpBatch } = require('@teragrep/rlp_02')
mvn clean package
-----------------

* OPTIONAL *TIPS*

* Optional tips:
+
async waterfall method also possible for run in the node engine (need to adjust the code).

== Configuration
Expand Down Expand Up @@ -96,3 +99,24 @@ log4js.configure( {
-----------------

This configuration will send the log event messages to the RELP Server.

== 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/jsa_01/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.

0 comments on commit f1ac8e8

Please sign in to comment.