February 2026

Nginx Log Analysis & Monitoring Tool

Nginx Log Analysis & Monitoring Tool screenshot 1

About This Project

A log analysis and real-time monitoring CLI tool for nginx access logs. Combines Bash text processing for core analysis with a Python based analyser, alerting system, and live terminal dashboard. The tool provides multiple ways to interact with nginx logs: - Bash Analysis: Shell one-liners for top IPs, frequent visitors, popular paths, and 404 detection - Python Parser: Structured parsing of nginx combined log format into typed dataclasses - Analysis Engine: IP ranking, status breakdowns, bandwidth analysis, request rate bucketing - Real-time Monitor: Tail logs and detect anomalies (rate limiting, error spikes, 404 storms) - Terminal Dashboard: Live-updating rich TUI with stats, top IPs, status distribution, and alerts - Sample Data Generator: Produces realistic nginx logs for testing The alerting system is configurable via YAML, with rules for rate limiting (100 req/60s per IP), error spike detection (>5% 5xx in 60s), and 404 storm detection (>20 unique 404s/60s).

Technologies Used

PythonBashRichPyYAMLPytestArgparseDataclasses