2023-12-15 16:35:41 +01:00
<!--
2024-02-08 14:23:29 +01:00
SPDX-FileCopyrightText: 2023-2024 Winni Neessen < wn @ neessen . dev >
2023-12-15 16:35:41 +01:00
SPDX-License-Identifier: MIT
//-->
2023-12-27 17:23:25 +01:00
# Logranger
2024-03-21 15:39:31 +01:00
[![GoDoc ](https://godoc.org/github.com/wneessen/logranger?status.svg )](https://pkg.go.dev/github.com/wneessen/logranger)
[![Go Report Card ](https://goreportcard.com/badge/github.com/wneessen/logranger )](https://goreportcard.com/report/github.com/wneessen/logranger)
2023-12-27 17:33:38 +01:00
[![#logranger on Discord ](https://img.shields.io/badge/Discord-%23logranger-blue.svg )](https://discord.gg/ysQXkaccXk)
2024-03-21 15:39:31 +01:00
[![REUSE status ](https://api.reuse.software/badge/github.com/wneessen/logranger )](https://api.reuse.software/info/github.com/wneessen/logranger)
2023-12-27 17:33:38 +01:00
< a href = "https://ko-fi.com/D1D24V9IX" > < img src = "https://uploads-ssl.webflow.com/5c14e387dab576fe667689cf/5cbed8a4ae2b88347c06c923_BuyMeACoffee_blue.png" height = "20" alt = "buy ma a coffee" > < / a >
2023-12-27 17:23:25 +01:00
*Note:* Logranger is still WIP
## Introduction
Logranger is a powerful and intelligent log processing tool written in Go.
Its main purpose is to efficiently process a large number of incoming syslog messages,
enabling you filter for specific events and perform actions based on the received events.
## Features
- **Efficient log processing**: Logranger is based on the performand
[go-parsesyslog ](https://github.com/wneessen/go-parsesyslog ) package and can handle and
analyze large volumes of syslog messages without compromising on its speed or performance.
- **Powerful rule-based filtering**: You can filter for log events based on a rules that
specify regular expressions to match the events.
- **Customization**: Logranger is easily customizable. Its easy to implement plugin interface
allows you to write your own plugins to perform custom actions with your events.
- **Custom templates**: Matched (or sub-matched) event log messages can be processed using
Go's versatile templating language.
## Plugins
By default Logranger ships with a varity of action plugins:
- **File action**: Store the matched (or a sub-match) event log messages in a file. The
file can be used in overwrite or append mode.
## License
Logranger is released under the [MIT License ](LICENSE ).
## Support
2024-03-21 15:39:31 +01:00
If you encounter any problems while using Logranger, please [create an issue ](https://github.com/wneessen/logranger/issues ) in this
repository. We appreciate any feedback or suggestions for improving Logranger.