https://github.com/meap/logwatch-llm
This command-line tool transforms your standard logwatch output into clear, human-readable HTML reports. More than just translation, it intelligently classifies the importance of detected issues, helping you focus on what needs immediate attention.
https://github.com/meap/logwatch-llm
ai-based automation devops golang log-analysis logwatch security security-tools
Last synced: 9 months ago
JSON representation
This command-line tool transforms your standard logwatch output into clear, human-readable HTML reports. More than just translation, it intelligently classifies the importance of detected issues, helping you focus on what needs immediate attention.
- Host: GitHub
- URL: https://github.com/meap/logwatch-llm
- Owner: meap
- License: mit
- Created: 2025-05-10T06:14:44.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-05-13T08:13:41.000Z (about 1 year ago)
- Last Synced: 2025-09-07T21:41:31.893Z (10 months ago)
- Topics: ai-based, automation, devops, golang, log-analysis, logwatch, security, security-tools
- Language: Go
- Homepage:
- Size: 16.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Logwatch LLM reports
## Installation from Source
> **Requirements:** Go 1.24 or newer must be installed on your system. See [https://go.dev/doc/install](https://go.dev/doc/install) for details.
To install Logwatch LLM reports from source on Linux, follow these steps:
1. **Clone the Repository**
```sh
git clone https://github.com/meap/logwatch-llm.git
cd logwatch-llm
```
2. **Build the Project**
Use the provided Makefile to build the binary:
```sh
make build
```
The compiled binary will be located in the `bin/` directory as `logwatch-llm`.
3. **(Optional) Install the Binary System-wide**
To make the CLI available system-wide:
```sh
sudo cp bin/logwatch-llm /usr/local/bin/
```
### Permissions and Ownership After Install
After copying the binary to `/usr/local/bin`, ensure it is executable and securely owned:
```sh
sudo chmod 755 /usr/local/bin/logwatch-llm
sudo chown root:root /usr/local/bin/logwatch-llm
```
This makes the binary usable by all users and prevents unauthorized modifications.
## Running with Logwatch via Cron
To automate Logwatch analysis and reporting, you can run Logwatch and pipe its output directly to Logwatch LLM using a cron job. For example, to run this daily and email the report:
1. Edit your crontab:
```sh
crontab -e
```
2. Add a line like this (adjust paths and email as needed):
```sh
0 7 * * * /usr/sbin/logwatch | /usr/local/bin/logwatch-llm --model gpt-4o --email your@email.com
```
This will run Logwatch at 7:00 AM every day, analyze the output with the LLM, and send the report to your email.