Skip to content

DumbNoxx/goxe

Repository files navigation

Made with VHS

reduce large volumes of repetitive logs into compact, readable aggregates.

goxe is a high-performance log reduction tool written in go. it ingests logs (currently via syslog/udp), normalizes and filters them, and aggregates repeated messages into a single-line format with occurrence counts. the result is less noise, lower bandwidth usage, and cheaper storage without losing visibility into recurring issues.

goxe is designed to run continuously in the background as part of a logging pipeline or sidecar.

Compile License

recommended install

go install github.com/DumbNoxx/goxe/cmd/goxe@latest

other installation methods and full usage examples are available in the documentation.

requirements (for building from source / contributing)

  • go 1.25.5 or higher

build from source:

git clone https://github.com/dumbnoxx/goxe.git
cd goxe
go install ./... 

aggregation behavior

goxe performs several transformations before aggregation:

  • strips timestamps and date prefixes
  • converts text to lowercase
  • removes extra whitespace
  • filters out configurable excluded words
  • applies basic ascii beautification

after normalization, identical messages are grouped together and reported with repetition counts.

example input:

dec 24, 2025 16:30:17 ERROR: connection failed 001 128.54.69.12
dec 24, 2025 16:30:18 ERROR: connection failed 002 128.34.70.12
dec 24, 2025 16:30:19 ERROR: connection failed 003 128.54.69.12

aggregated output:

        partial report
----------------------------------
origin: [::1]
- [3] ERROR: connection failed *  -- (first seen 16:30:17 - last seen 16:30:19)
----------------------------------

documentation

visit our official documentation

contrib

  1. fork
  2. implement change
  3. open pr

please read CONTRIBUTING.

maintainers

license

apache 2.0

About

goxe is a log reduction tool written in go. it normalizes, filters, and aggregates repeated messages. the result is less noise, lower bandwidth, and cheaper storage without losing visibility into recurring issues.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors