JarCasting
JarCasting JarCasting

ebx-structuredlogging-sdk

ebx-structuredlogging-sdk intends to make including structured logging data as easy as possible.

License

License
Categories

Categories

Logging Application Layer Libs
GroupId

GroupId

com.echobox
ArtifactId

ArtifactId

ebx-structuredlogging-sdk
Last Version

Last Version

1.0.0
Release Date

Release Date
Type

Type

jar
Description

Description

ebx-structuredlogging-sdk
ebx-structuredlogging-sdk intends to make including structured logging data as easy as possible.
Project URL

Project URL

https://github.com/ebx/ebx-structuredlogging-sdk
Source Code Management

Source Code Management

https://github.com/ebx/ebx-structuredlogging-sdk

Download ebx-structuredlogging-sdk

Filename Size
ebx-structuredlogging-sdk-1.0.0.pom
ebx-structuredlogging-sdk-1.0.0.jar 6 KB
ebx-structuredlogging-sdk-1.0.0-sources.jar 6 KB
ebx-structuredlogging-sdk-1.0.0-javadoc.jar 34 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/com.echobox/ebx-structuredlogging-sdk/ -->
<dependency>
    <groupId>com.echobox</groupId>
    <artifactId>ebx-structuredlogging-sdk</artifactId>
    <version>1.0.0</version>
</dependency>
// https://jarcasting.com/artifacts/com.echobox/ebx-structuredlogging-sdk/
implementation 'com.echobox:ebx-structuredlogging-sdk:1.0.0'
// https://jarcasting.com/artifacts/com.echobox/ebx-structuredlogging-sdk/
implementation ("com.echobox:ebx-structuredlogging-sdk:1.0.0")
'com.echobox:ebx-structuredlogging-sdk:jar:1.0.0'
<dependency org="com.echobox" name="ebx-structuredlogging-sdk" rev="1.0.0">
  <artifact name="ebx-structuredlogging-sdk" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.echobox', module='ebx-structuredlogging-sdk', version='1.0.0')
)
libraryDependencies += "com.echobox" % "ebx-structuredlogging-sdk" % "1.0.0"
[com.echobox/ebx-structuredlogging-sdk "1.0.0"]

Dependencies

compile (4)

Group / Artifact Type Version
org.slf4j : slf4j-api jar 1.7.30
org.slf4j : slf4j-ext jar 1.7.30
ch.qos.logback : logback-classic jar 1.2.3
net.logstash.logback : logstash-logback-encoder jar 6.4

Project Modules

There are no modules declared in this project.

Maven Central License Build Status

ebx-structuredlogging-sdk

Logging is a critical pillar of service observability. Occasionally it's desirable to include structured information and depending on the logging solution these can then be more easily graphed, analysed etc, for example with loggly.

This library intends to make including such structured logging as easy as possible by allowing structured arguments to be included in ch.qos.logback.classic.net.SyslogAppender.

How to use

  1. Include this sdk (assuming maven):
<dependency>
  <groupId>com.echobox</groupId>
  <artifactId>ebx-structuredlogging-sdk</artifactId>
  <version>1.0.0</version>
</dependency>
  1. Update the relevant project logback.xml file to include the extended SyslogAppender config:
<!-- Get an optional threadid, tid, value for logging -->
<conversionRule conversionWord="tid" converterClass="com.echobox.logging.ThreadIdConverter" />

<!-- Congiure the structured SyslogAppender -->
<appender name="SYSLOG" class="com.echobox.logging.SyslogAppenderWithAppendix">
<syslogHost>localhost</syslogHost>
<facility>USER</facility>
<suffixPattern>[%logger] %nopex</suffixPattern>
<appendixLayout
  class="net.logstash.logback.layout.LoggingEventCompositeJsonLayout">
  <providers>
    <pattern>
      <pattern>{ "threadId": "%tid-%thread", "message": "%msg", "exception":"%rEx{30}" }</pattern>
    </pattern>
    <arguments />
  </providers>
</appendixLayout>
</appender>

The pattern can be modified as required, see here.

  1. Start including net.logstash.logback.argument.StructuredArguments where required:
Map<String, Object> loggingMap = new HashMap<>();
loggingMap.put("executionTimeMS", endTimeMS - startTimeMS);
logger.debug("Completed execution in MS {}", StructuredArguments.entries(loggingMap));

or

logger.warn(...

etc.

Getting in touch

  • GitHub Issues: If you have ideas, bugs, or problems with our library, just open a new issue.

Contributing

If you would like to get involved please follow the instructions here

Releases

We use semantic versioning.

All merges into DEV will automatically get released as a maven central snapshot, which can be easily included in any downstream dependencies that always desire the latest changes (see above for 'Most Up To Date' installation).

Each merge into the MASTER branch will automatically get released to Maven central and github releases, using the current library version. As such, following every merge to master, the version number of the dev branch should be incremented and will represent 'Work In Progress' towards the next release.

Please use a merge (not rebase) commit when merging dev into master to perform the release.

To create a full release to Maven central please follow these steps:

  1. Ensure the CHANGELOG.md is up to date with all the changes in the release, if not please raise a suitable PR into DEV. Typically the change log should be updated as we go.
  2. Create a PR from DEV into MASTER. Ensure the version in the pom.xml is the correct version to be released. Merging this PR into MASTER will automatically create the maven and github releases. Please note that a release is final, it can not be undone/deleted/overwritten.
  3. Once the public release has been successful create a final PR into DEV that contains an incremented pom.xml version to ensure the correct snapshot gets updated on subsequent merges into DEV. This PR should also include:
    • An update to the README.md latest stable release version number.
    • A 'Work In Progress' entry for the next anticipated release in CHANGELOG.md.
com.echobox

Echobox

Using the power of Microservices, Big Data and ML to intelligently automate publishing.

Versions

Version
1.0.0