Skip to content

v0.1.0 - Initial Release

Latest

Choose a tag to compare

@brunseba brunseba released this 05 Feb 08:59
· 1 commit to main since this release

🎉 Initial Release

A lightweight, pure Python syslog forwarder with simple YAML configuration.

Features

  • Inputs: UDP and TCP listeners with asyncio
  • Parsing: RFC 3164 and RFC 5424 message formats
  • Filtering: Route by facility, severity, hostname, or message patterns
  • Transformations: Remove fields, set fields, mask patterns, replace, prefix/suffix
  • Outputs: UDP and TCP forwarders with retry logic
  • Monitoring: Prometheus metrics (/metrics) and health check (/health)
  • CLI: run, validate, simulate, init, export commands
  • Export: Convert config to syslog-ng format
  • Docker: Multi-stage build with slim image
  • Sandbox: Docker Compose with Prometheus and Grafana
  • Dashboard: Grafana dashboard for metrics visualization
  • Testing: Performance tests (burst and long-running modes)
  • Documentation: Architecture diagrams, user guide, MkDocs site

Installation

pipx install syslog-fwd

Quick Start

syslog-fwd init -o config.yaml
syslog-fwd validate -c config.yaml
syslog-fwd run -c config.yaml

See the User Guide for detailed documentation.