Repository navigation
🎉 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,exportcommands - 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-fwdQuick Start
syslog-fwd init -o config.yaml
syslog-fwd validate -c config.yaml
syslog-fwd run -c config.yamlSee the User Guide for detailed documentation.