PHP Log Analyzer for Hetzner DR Server

Automated PHP log analysis tool for WordPress/WooCommerce sites on cPanel servers.

Features

• I/O Impact Analysis: Identifies large log files affecting disk I/O (>100MB critical, >20MB heavy)
• Plugin Detector: Ranks WordPress plugins by error count
• Error Categorization: Fatal, Warning, Notice, Deprecated
• Performance Monitoring: Memory, timeout, database errors
• Daily Email Reports: Prioritized alerts via SMTP
• 30-day Report Retention: Automatic cleanup of old reports

Installation

Prerequisites

• AlmaLinux/CentOS with cPanel
• Exim mail server configured
• Root access

Deploy Script

# Copy script to server
scp php_log_analyzer_v2.sh root@your-server:/root/scripts/

# Make executable
ssh root@your-server "chmod +x /root/scripts/php_log_analyzer_v2.sh"

# Create log directory
ssh root@your-server "mkdir -p /var/log/php_analysis"

Configure Crontab

# Add to root crontab (runs daily at 10:00)
0 10 * * * /root/scripts/php_log_analyzer_v2.sh >/dev/null 2>&1

Manual Test

/root/scripts/php_log_analyzer_v2.sh

Configuration

Edit the script to customize:

# Email settings
EMAIL_TO="your-email@example.com"
EMAIL_FROM="alert@yourdomain.com"

# Thresholds (bytes)
CRITICAL_SIZE=$((100 * 1024 * 1024))  # 100MB
HEAVY_SIZE=$((20 * 1024 * 1024))       # 20MB

# Report retention
RETENTION_DAYS=30

# Accounts to monitor
declare -a ACCOUNTS=(
    "user1:domain1.com"
    "user2:domain2.com,domain3.com"
)

Output Files

Path	Description
/var/log/php_log_analyzer.log	Script execution log
/var/log/php_analysis/YYYYMMDD_HHMMSS/	Analysis directory
REPORT_PHP_ANALYSIS.md	Full markdown report
email_body.txt	Email content
01_FATAL_ERRORS.txt	Fatal errors only
global_plugin_ranking.txt	Plugin error ranking

Alert Levels

Level	Condition	Action
CRITICAL	Fatal errors, Memory errors, Timeout, Log >100MB	Immediate action required
WARNING	>1000 warnings, >10 DB errors, Log >20MB	Schedule fix
OK	Everything normal	Routine maintenance

Email Format

Reports are prioritized:

1. Critical Issues (if any)
2. Top 5 Noisy Plugins
3. Account Summary Table

Troubleshooting

Email not received

exim -bpc                           # Check queue
tail -50 /var/log/exim_mainlog      # Check logs

Script not running

bash -x /root/scripts/php_log_analyzer_v2.sh  # Debug mode

License

MIT License - See LICENSE file

Author

SAM Consulting for La Friterie srls