CrimsonWatch
Overview
CrimsonWatch is a lightweight, background logging and security watcher written in TypeScript. It monitors targeted system/app log files in real-time, matching patterns using regular expressions (such as authentication failures, database timeouts, or critical error logs), and dispatches structured event notifications to external webhook endpoints.
Key Features
- ⏱️ Live Stream Monitoring: Hooks into file system change events to tail files asynchronously with minimal resource footprints.
- 🔍 Regex Matching Engine: Supports user-defined regex filters to capture specific alert signatures in log text.
- webhook Notifications: Dispatches alerts containing context snippets to Slack, Discord, or generic webhook integrations.
- 📦 Low Footprint: Optimized Node.js daemon running cleanly inside minimal Docker environments.
Tech Stack
| Technology | Purpose |
|---|---|
| TypeScript / Node.js | Core Watcher Logic |
| Chokidar | File System Watcher |
| Axios | Webhook Notification client |
Real-time log auditing and event dispatcher for distributed runtimes.