{"id":26233983,"url":"https://github.com/teragrep/jla_01","last_synced_at":"2025-09-08T06:35:40.421Z","repository":{"id":51369390,"uuid":"341173173","full_name":"teragrep/jla_01","owner":"teragrep","description":"Teragrep RELP plugin for Logback ","archived":false,"fork":false,"pushed_at":"2025-01-03T19:16:59.000Z","size":91,"stargazers_count":1,"open_issues_count":9,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-29T15:02:09.966Z","etag":null,"topics":["java","log","log-management","logback","logback-appender","logger","relp","relp-client","syslog","syslog-client","teragrep"],"latest_commit_sha":null,"homepage":"https://teragrep.com","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/teragrep.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-02-22T11:12:21.000Z","updated_at":"2025-01-28T11:47:38.000Z","dependencies_parsed_at":"2022-08-25T14:51:06.415Z","dependency_job_id":"d694325a-5be1-406d-b6fb-e7f386003ae7","html_url":"https://github.com/teragrep/jla_01","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teragrep%2Fjla_01","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teragrep%2Fjla_01/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teragrep%2Fjla_01/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teragrep%2Fjla_01/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/teragrep","download_url":"https://codeload.github.com/teragrep/jla_01/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250237834,"owners_count":21397401,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","log","log-management","logback","logback-appender","logger","relp","relp-client","syslog","syslog-client","teragrep"],"created_at":"2025-03-13T01:18:22.141Z","updated_at":"2025-09-08T06:35:40.408Z","avatar_url":"https://github.com/teragrep.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"image::https://scan.coverity.com/projects/22709/badge.svg[link=https://scan.coverity.com/projects/jla_01]\n\n== RELP Logging plugin for Logback\n\nSee link:https://github.com/teragrep/jla_01/blob/master/src/main/resources/logback.example.xml[logback.example.xml] for example config\n\n== Parameters\n\n|===\n|Parameter |Description | Default\n\n|`relpHostAddress`\n|Connection destination address\n|127.0.0.1\n\n|`relpPort`\n|Connection destination port\n|601\n\n|`enableEventId48577`\n|Enables structured data containing uuid and source information\n|true\n\n|`appName`\n|Stream application identifier. Maximum length of 48 characters, limited by RFC5424\n|jla-01\n \n|`hostname`\n|Stream host identifier. Maximum length of 255 characters, limited by RFC5424\n|localhost.localdomain\n \n|`connectionTimeout`\n|Time to wait before timing out connection in milliseconds\n|2500\n \n|`reconnectInterval`\n|Time to wait between re-connection attempts in milliseconds\n|500\n \n|`writeTimeout`\n|Time to wait for destination to accept data in milliseconds\n|1500\n \n|`readTimeout`\n|Time to wait for destination to acknowledge sent data (low values cause duplicates) in milliseconds\n|1500\n \n|`keepAlive`\n|Enables sending alive packets.\n|true\n \n|`reconnectIfNoMessagesInterval`\n|Reconnects before sending message if at least X milliseconds have passed since last message. Set to 0 to turn off automatic reconnections.\n|150000\n\n|`connectOnStart`\n|Start one connection initially at appender start. Allows detection of configuration mistakes early.\n|false\n\n|`rebindEnabled`\n|Rebind RELP connection after `rebindAmount` of records.\n|true\n\n|`rebindAmount`\n|Rebind after this amount of records sent if `rebindEnabled` is set.\n|100000\n\n|`synchronizedAccess`\n|Allows only one thread at a time to append, therefore uses only one connection.\n|false\n\n|`useTLS`\n|Use TLS instead of a plain text connection.\n|false\n\n|`keystorePath`\n|Path to Java keystore that includes the CA certificate for the TLS connection\n|/unset/path/to/keystore\n\n|`keystorePassword`\n|Keystore password for the keystore defined in `keystorePath`\n|\n\n|`enableSystemID`\n|Enables emission of metadata from `systemID` configuration.\n|\n\n|`systemID`\n|Configurable metadata which inserted into rfc5424 structured-data element `businessSystem@48577` with key `systemId` if `enableSystemID` is set.\n|\n\n|===\n\n\n== jboss-module\n\nThese instructions are untested but should work none the less.\njla_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/\n\n=== Inclusion\n\nCopy the jar into $EAP_HOME/modules.\n\nInclude module by using following convetion to target module.xml (which may be quite many).\n```\n\u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n\u003cmodule ...\u003e\n\u003c.../\u003e\n\u003cdependencies\u003e\n\u003cmodule name=\"com.teragrep.jla_01\"/\u003e\n\u003c/dependencies\u003e\n\u003c.../\u003e\n\u003c/module\u003e\n```\n\nOne may wish to add this as a global module according to following link in order to avoid multiple inclusions:\nhttps://access.redhat.com/documentation/en-us/red_hat_jboss_enterprise_application_platform/7.0/html-single/configuration_guide/index#add_a_global_module\n\n== Configuring pre-built Logback application\n\nFirst download wanted versions of jla_01, rlp_01, tls_01 and rlo_14 from the following urls:\n\n* https://search.maven.org/artifact/com.teragrep/jla_01[jla_01]\n* https://search.maven.org/artifact/com.teragrep/rlp_01[rlp_01]\n* https://search.maven.org/artifact/com.teragrep/tls_01[tls_01]\n* https://search.maven.org/artifact/com.teragrep/rlo_14[rlo_14]\n\nThen run java while pointing classpath to the directory where you downloaded the jars to like:\n\n```\njava -cp \"path/to/downloaded/jars/*:target/example.jar\" com.teragrep.example.Main\n```\n\n== Contributing\n \n// Change the repository name in the issues link to match with your project's name\n \nYou can involve yourself with our project by https://github.com/teragrep/jla_01/issues/new/choose[opening an issue] or submitting a pull request.\n \nContribution requirements:\n \n. *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.\n. Security checks must pass\n. Pull requests must align with the principles and http://www.extremeprogramming.org/values.html[values] of extreme programming.\n. Pull requests must follow the principles of Object Thinking and Elegant Objects (EO).\n \nRead more in our https://github.com/teragrep/teragrep/blob/main/contributing.adoc[Contributing Guideline].\n \n=== Contributor License Agreement\n \nContributors 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.\n \nYou need to submit the CLA only once. After submitting the CLA you can contribute to all Teragrep's repositories. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteragrep%2Fjla_01","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteragrep%2Fjla_01","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteragrep%2Fjla_01/lists"}