A Telex integration specialized in monitoring and reporting Nginx error logs. This service analyzes Nginx error logs and reports them through Telex's webhook system, with planned support for remote Nginx instances.
Current Features:
- Local Nginx error log monitoring
- Intelligent error parsing and classification
- Configurable error thresholds
- Severity-based error categorization
- Real-time Nginx error detection
- Detailed error analysis and reporting
Upcoming Features:
- Remote Nginx instance monitoring
- Multi-instance support
- Dynamic log source configuration
- Real-time remote log streaming
- User authentication and access control
- Custom alert configurations per instance
- Dashboard for monitoring multiple Nginx servers
- Node.js v20.11.1 or higher
- npm v10.x or higher
- Access to Nginx error logs
- Telex webhook URL (for production)
- Clone the repository:
git clone <repository-url>
cd nginxLogErrorTracker
- Install dependencies:
npm install
- Configure environment variables:
cp .env.example .env
# Edit .env with your configuration
Create a .env
file with the following variables:
NODE_ENV=development
NGINX_LOG_PATH=C:\\nginx-1.27.4\\logs\\error.log # Update with your Nginx log path
ERROR_THRESHOLD=1
TELEX_WEBHOOK_URL=https://telex.example.com/webhook
npm run start
npm test
npm run manual-test
The system classifies Nginx errors into the following severity levels:
- 🔴 Emergency/Critical (emerg, alert, crit) - Severity 7-5
- 🔴 Error (error) - Severity 4
- 🟡 Warning (warn) - Severity 3
- 🟢 Notice (notice) - Severity 2
- ℹ️ Info (info) - Severity 1
- 🔍 Debug (debug) - Severity 0
-
Remote Instance Support
- Secure remote log access
- Multiple instance management
- Instance health monitoring
-
User Management
- Authentication system
- Role-based access control
- Instance access permissions
-
Enhanced Monitoring
- Real-time dashboard
- Custom alert rules
- Historical data analysis
-
Advanced Features
- Log pattern learning
- Predictive error detection