Java library and CLI tool for decoding Log10x-encoded log events back to their original form. Log10x losslessly compacts log events by extracting recurring structure into templates and storing only the variable values — this library reverses that process.
| Module | Description |
|---|---|
log10x-decoder-core |
Core decoding library — use this as a dependency in your Java applications |
log10x-decoder-cli |
Command-line tool for decoding encoded log files |
<dependency>
<groupId>com.log10x</groupId>
<artifactId>log10x-decoder-core</artifactId>
<version>1.0.1</version>
</dependency>implementation 'com.log10x:log10x-decoder-core:1.0.1'import com.log10x.decode.SingleEventDecoder;
import com.log10x.decode.lexer.TokenizeContext;
String decoded = SingleEventDecoder.decode(
TokenizeContext.DEFAULT,
templateHash,
encodedEvent,
templatePattern
);# Decode a file
log10x-decode -t templates.json -f encoded.log -o decoded.log
# Decode from stdin
cat encoded.log | log10x-decode -t templates.json- Java 8+ (JDK)
- Gradle 7+
./gradlew build./gradlew :log10x-decoder-cli:shadowJar./gradlew :log10x-decoder-cli:nativeImageReleases are published via GitHub Actions, triggered by pushing git tags.
Each module has its own tag suffix and workflow:
| Module | Tag format | Workflow |
|---|---|---|
log10x-decoder-core |
v{version}-core |
publish-core.yml |
log10x-decoder-cli |
v{version}-cli |
publish-cli.yml |
The version is extracted from the tag automatically (e.g., tag v1.0.0-core publishes version 1.0.0).
Core must be published before CLI, since the CLI pulls core from Maven Central as a dependency. Wait for core to appear on Maven Central before tagging CLI.
# 1. Tag and push core
git tag v1.0.0-core
git push origin v1.0.0-core
# 2. Wait for core to appear on Maven Central (~10-30 min)
# 3. Tag and push CLI
git tag v1.0.0-cli
git push origin v1.0.0-cli- JavaScript — log10x-decoder-js — Browser and Node.js, npm
This repository is licensed under the MIT License.
This repository contains a decoder library for Log10x-encoded events. While the decoder itself is open source, using the 10x Engine to encode events requires a commercial license.
| Component | License |
|---|---|
| This repository (decoder library & CLI) | MIT (open source) |
| The 10x Engine | Commercial license required |
What this means:
- You can freely use, modify, and distribute this decoder
- The 10x Engine that generates encoded events requires a paid subscription
- A valid Log10x license is required to run the 10x Engine
Get Started:
Contributions are welcome! Please read our contributing guidelines and submit pull requests to the repository.
For issues and feature requests:
- Open an issue on GitHub
- Contact the Log10x team at support@log10x.com