pms_md 1.0.0

package/node-monitor/examples/GET_APP_PASSWORD.md

@@ -0,0 +1,145 @@
+# 🔐 How to Get Gmail App Password
+
+## ⚠️ Current Issue
+
+You're seeing this error:
+```
+Invalid login: 535 5.7.8 Username and Password not accepted
+```
+
+This means you need to create a **Gmail App Password**.
+
+---
+
+## 📝 Step-by-Step Instructions
+
+### **Step 1: Enable 2-Step Verification** (if not already enabled)
+
+1. Open: https://myaccount.google.com/security
+2. Scroll to "How you sign in to Google"
+3. Click **"2-Step Verification"**
+4. Follow the setup process (takes 2-3 minutes)
+
+### **Step 2: Create App Password**
+
+1. Open: **https://myaccount.google.com/apppasswords**
+2. You may need to sign in again
+3. Under "Select app", choose: **Mail**
+4. Under "Select device", choose: **Other (Custom name)**
+5. Type: **Node Monitor**
+6. Click **"Generate"**
+
+### **Step 3: Copy the Password**
+
+You'll see a 16-character password like this:
+```
+abcd efgh ijkl mnop
+```
+
+**IMPORTANT:** Remove all spaces! It should be:
+```
+abcdefghijklmnop
+```
+
+### **Step 4: Update .env File**
+
+1. Open the file: `node-monitor/examples/.env`
+2. Find this line:
+   ```env
+   EMAIL_APP_PASSWORD=your-gmail-app-password-here
+   ```
+3. Replace it with your password:
+   ```env
+   EMAIL_APP_PASSWORD=abcdefghijklmnop
+   ```
+4. **Save the file!**
+
+### **Step 5: Restart the Server**
+
+Stop the current server (Ctrl+C) and restart:
+```bash
+cd node-monitor/examples
+node express-app.js
+```
+
+### **Step 6: Test Again**
+
+Visit: http://localhost:3001/api/notify-test
+
+You should now see:
+```json
+{
+  "successful": 1,
+  "failed": 0
+}
+```
+
+And receive an email at: **manish.proses@gmail.com**
+
+---
+
+## 🚨 Troubleshooting
+
+### Problem: "2-Step Verification not enabled"
+
+You MUST enable 2-Step Verification first:
+1. Go to: https://myaccount.google.com/security
+2. Enable 2-Step Verification
+3. Then create App Password
+
+### Problem: "Can't find App Passwords option"
+
+Make sure:
+- ✅ You're signed in to: manish.proses@gmail.com
+- ✅ 2-Step Verification is enabled
+- ✅ You're using this direct link: https://myaccount.google.com/apppasswords
+
+### Problem: Still getting "Invalid login"
+
+Check:
+- ✅ You copied the ENTIRE 16-character password
+- ✅ You removed ALL spaces
+- ✅ You saved the .env file
+- ✅ You restarted the server
+
+---
+
+## 📧 Alternative: Use a Different Email Service
+
+If you don't want to use Gmail App Passwords, you can use:
+
+### **Option 1: Gmail with Less Secure Apps** (Not Recommended)
+- Not available for accounts with 2FA
+
+### **Option 2: SendGrid** (Free tier available)
+1. Sign up at: https://sendgrid.com
+2. Get API key
+3. Update configuration
+
+### **Option 3: Mailgun** (Free tier available)
+1. Sign up at: https://www.mailgun.com
+2. Get SMTP credentials
+3. Update configuration
+
+---
+
+## ✅ Quick Checklist
+
+- [ ] 2-Step Verification enabled on Gmail
+- [ ] App Password created
+- [ ] Password copied (16 characters, no spaces)
+- [ ] .env file updated
+- [ ] .env file saved
+- [ ] Server restarted
+- [ ] Test endpoint visited
+
+---
+
+## 🎯 Need Help?
+
+If you're still having issues, share:
+1. Screenshot of the error
+2. Confirm 2-Step Verification is enabled
+3. Confirm you created an App Password
+4. Confirm you updated and saved .env file
+

package/node-monitor/examples/LOG_FILES_REFERENCE.md

@@ -0,0 +1,336 @@
+# 📁 Log Files Reference
+
+## 📍 Quick Access
+
+### **Web Interface:**
+```
+http://localhost:3001/monitor/error-logs
+```
+
+### **File Location:**
+```
+node-monitor/examples/logs/
+```
+
+---
+
+## 📂 Log Files
+
+### **Error Logs (Errors Only)**
+```
+logs/error-2025-11-12.log
+logs/error-2025-11-11.log
+logs/error-2025-11-10.log
+...
+```
+
+**Contains:** API errors, system errors, critical failures
+
+### **Application Logs (All Events)**
+```
+logs/application-2025-11-12.log
+logs/application-2025-11-11.log
+logs/application-2025-11-10.log
+...
+```
+
+**Contains:** Info, warnings, errors, debug messages
+
+---
+
+## 📋 Log Entry Format
+
+### **Error Log Entry Example:**
+
+```json
+{
+  "level": "error",
+  "message": "API Error This is a test error",
+  "type": "API_ERROR",
+  "method": "GET",
+  "url": "/api/error",
+  "statusCode": 500,
+  "timestamp": "2025-11-12T06:00:03.618Z",
+  "ip": "::1",
+  "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)...",
+  "headers": {
+    "accept": "text/html,application/xhtml+xml...",
+    "host": "localhost:3001",
+    "user-agent": "Mozilla/5.0..."
+  },
+  "query": {},
+  "body": {},
+  "stack": "Error: This is a test error\n    at ApiErrorMonitor.createError...",
+  "app": {
+    "name": "Example Express App",
+    "version": "1.0.0",
+    "environment": "production",
+    "hostname": "MD"
+  }
+}
+```
+
+---
+
+## 🔍 Key Fields
+
+| Field | Type | Description | Example |
+|-------|------|-------------|---------|
+| `level` | string | Log severity | `"error"`, `"warn"`, `"info"` |
+| `message` | string | Error message | `"API Error This is a test error"` |
+| `type` | string | Error category | `"API_ERROR"`, `"SYSTEM_ERROR"` |
+| `method` | string | HTTP method | `"GET"`, `"POST"`, `"PUT"` |
+| `url` | string | Request path | `"/api/error"` |
+| `statusCode` | number | HTTP status | `500`, `404`, `400` |
+| `timestamp` | string | ISO 8601 date | `"2025-11-12T06:00:03.618Z"` |
+| `ip` | string | Client IP | `"::1"`, `"192.168.1.1"` |
+| `userAgent` | string | Browser/client | `"Mozilla/5.0..."` |
+| `headers` | object | HTTP headers | `{ "accept": "...", ... }` |
+| `query` | object | URL params | `{ "id": "123" }` |
+| `body` | object | Request body | `{ "username": "..." }` |
+| `stack` | string | Stack trace | `"Error: ...\n at ..."` |
+| `app.name` | string | App name | `"Example Express App"` |
+| `app.version` | string | App version | `"1.0.0"` |
+| `app.environment` | string | Environment | `"production"`, `"development"` |
+| `app.hostname` | string | Server name | `"MD"` |
+
+---
+
+## 📊 Reading Logs
+
+### **Method 1: Web Interface**
+```
+http://localhost:3001/monitor/error-logs
+```
+- ✅ Beautiful UI
+- ✅ Filter by date
+- ✅ Expandable stack traces
+- ✅ Download as JSON
+
+### **Method 2: Command Line**
+
+**View latest errors:**
+```bash
+tail -n 10 logs/error-2025-11-12.log
+```
+
+**Count errors:**
+```bash
+wc -l logs/error-2025-11-12.log
+```
+
+**Search for specific error:**
+```bash
+grep "test error" logs/error-2025-11-12.log
+```
+
+**Pretty print JSON:**
+```bash
+cat logs/error-2025-11-12.log | jq '.'
+```
+
+### **Method 3: Node.js Script**
+
+```javascript
+const fs = require('fs');
+
+// Read and parse log file
+const logFile = 'logs/error-2025-11-12.log';
+const content = fs.readFileSync(logFile, 'utf8');
+
+// Parse each line as JSON
+const errors = content
+  .split('\n')
+  .filter(line => line.trim())
+  .map(line => JSON.parse(line));
+
+// Analyze
+console.log('Total errors:', errors.length);
+console.log('Latest error:', errors[errors.length - 1]);
+
+// Group by status code
+const byStatus = errors.reduce((acc, err) => {
+  acc[err.statusCode] = (acc[err.statusCode] || 0) + 1;
+  return acc;
+}, {});
+console.log('Errors by status code:', byStatus);
+```
+
+### **Method 4: API Endpoint**
+
+```bash
+# Get errors as JSON
+curl "http://localhost:3001/monitor/error-logs/error-2025-11-12.log?format=json&limit=10"
+
+# Download log file
+curl "http://localhost:3001/monitor/error-logs/error-2025-11-12.log" -o error-log.json
+```
+
+---
+
+## 🔄 Log Rotation
+
+### **Automatic Rotation:**
+- ✅ New file created daily at midnight
+- ✅ Old files kept for 14 days
+- ✅ Files automatically deleted after 14 days
+- ✅ Maximum file size: 20MB
+
+### **File Naming:**
+```
+error-YYYY-MM-DD.log
+application-YYYY-MM-DD.log
+```
+
+**Example:**
+```
+error-2025-11-12.log  ← Today
+error-2025-11-11.log  ← Yesterday
+error-2025-11-10.log  ← 2 days ago
+...
+error-2025-10-29.log  ← 14 days ago (will be deleted tomorrow)
+```
+
+---
+
+## 🛡️ Sensitive Data Protection
+
+### **Automatically Redacted Fields:**
+- `password`
+- `token`
+- `apiKey`
+- `secret`
+- `authorization`
+- Any field containing these keywords
+
+### **Example:**
+
+**Original Request:**
+```json
+{
+  "username": "john@example.com",
+  "password": "MySecret123",
+  "apiKey": "sk_live_abc123"
+}
+```
+
+**Logged as:**
+```json
+{
+  "username": "john@example.com",
+  "password": "***REDACTED***",
+  "apiKey": "***REDACTED***"
+}
+```
+
+---
+
+## 📥 Exporting Logs
+
+### **For Analysis:**
+```bash
+# Export last 100 errors
+curl "http://localhost:3001/monitor/error-logs/error-2025-11-12.log?format=json&limit=100" > errors.json
+```
+
+### **For Backup:**
+```bash
+# Copy all log files
+cp -r logs/ backup/logs-2025-11-12/
+```
+
+### **For Sharing:**
+```bash
+# Download specific log
+curl "http://localhost:3001/monitor/error-logs/error-2025-11-12.log" -o error-report.json
+```
+
+---
+
+## 🔍 Common Queries
+
+### **Find all 500 errors:**
+```bash
+cat logs/error-2025-11-12.log | jq 'select(.statusCode == 500)'
+```
+
+### **Find errors from specific URL:**
+```bash
+cat logs/error-2025-11-12.log | jq 'select(.url == "/api/error")'
+```
+
+### **Count errors by type:**
+```bash
+cat logs/error-2025-11-12.log | jq -r '.type' | sort | uniq -c
+```
+
+### **Get error messages only:**
+```bash
+cat logs/error-2025-11-12.log | jq -r '.message'
+```
+
+### **Find errors in last hour:**
+```bash
+cat logs/error-2025-11-12.log | jq --arg time "$(date -u -d '1 hour ago' +%Y-%m-%dT%H:%M:%S)" 'select(.timestamp > $time)'
+```
+
+---
+
+## 📧 Email Notifications
+
+When errors are logged, emails are sent to: **manish.proses@gmail.com**
+
+**Triggers:**
+- Single API error → Warning email
+- High error rate (>10/min) → Critical email
+- Consecutive failures (2+) → Critical email
+
+**Cooldown:** 3 minutes between emails
+
+---
+
+## 🎯 Quick Reference
+
+| Task | Command/URL |
+|------|-------------|
+| View errors in browser | http://localhost:3001/monitor/error-logs |
+| Download today's errors | http://localhost:3001/monitor/error-logs/error-2025-11-12.log |
+| Get errors as JSON | http://localhost:3001/monitor/error-logs/error-2025-11-12.log?format=json |
+| View latest 10 errors | `tail -n 10 logs/error-2025-11-12.log` |
+| Count total errors | `wc -l logs/error-2025-11-12.log` |
+| Search for error | `grep "keyword" logs/error-2025-11-12.log` |
+| Pretty print | `cat logs/error-2025-11-12.log \| jq '.'` |
+
+---
+
+## 📚 Documentation
+
+- **Full Guide:** `ERROR_LOGGING_GUIDE.md`
+- **Email Setup:** `EMAIL_SETUP_GUIDE.md`
+- **Quick Start:** `QUICK_START_EMAIL.md`
+
+---
+
+## ✅ Summary
+
+**Log Files:**
+- 📁 Location: `node-monitor/examples/logs/`
+- 📋 Format: JSON (one object per line)
+- 🔄 Rotation: Daily, kept for 14 days
+- 🛡️ Security: Sensitive data auto-redacted
+
+**Access:**
+- 🌐 Web: http://localhost:3001/monitor/error-logs
+- 📥 API: `/monitor/error-logs/:filename?format=json`
+- 📂 File: `logs/error-YYYY-MM-DD.log`
+
+**Features:**
+- ✅ Automatic logging
+- ✅ Beautiful web viewer
+- ✅ Email notifications
+- ✅ Downloadable logs
+- ✅ Stack traces
+- ✅ Request details
+
+**Perfect for debugging and monitoring your applications!** 🚀
+

package/node-monitor/examples/QUICK_START_EMAIL.md

@@ -0,0 +1,126 @@
+# 📧 Quick Start: Email Notifications
+
+## ⚡ 3-Step Setup
+
+### Step 1: Get Gmail App Password (2 minutes)
+
+1. Go to: https://myaccount.google.com/apppasswords
+2. Create App Password for "Mail"
+3. Copy the 16-character password (remove spaces)
+
+### Step 2: Update .env File (30 seconds)
+
+Open: `node-monitor/examples/.env`
+
+Replace:
+```env
+EMAIL_APP_PASSWORD=your-gmail-app-password-here
+```
+
+With your password:
+```env
+EMAIL_APP_PASSWORD=abcdefghijklmnop
+```
+
+### Step 3: Restart Server (10 seconds)
+
+```bash
+cd node-monitor/examples
+node express-app.js
+```
+
+---
+
+## ✅ Test It!
+
+Visit: http://localhost:3001/api/notify-test
+
+Or click the **"📧 Test Email"** button on the home page.
+
+**Check your inbox:** manish.proses@gmail.com
+
+---
+
+## 🚨 What Triggers Email Alerts?
+
+| Trigger | Threshold | Email Type |
+|---------|-----------|------------|
+| API Error | Any error | Warning ⚠️ |
+| High Error Rate | >10 errors/min | Critical 🚨 |
+| High CPU | >75% | Warning ⚠️ |
+| High Memory | >85% | Warning ⚠️ |
+| Slow Response | >3 seconds | Warning ⚠️ |
+| Server Crash | Any crash | Critical 🚨 |
+| DB Connection Fail | Any failure | Critical 🚨 |
+
+---
+
+## 🧪 Quick Tests
+
+### Test 1: Send Test Email
+```
+http://localhost:3001/api/notify-test
+```
+
+### Test 2: Trigger Error Alert
+```
+http://localhost:3001/api/error
+```
+(Click twice to trigger consecutive failure alert)
+
+### Test 3: Trigger High Error Rate
+```bash
+# Visit error endpoint 15 times
+for i in {1..15}; do curl http://localhost:3001/api/error; done
+```
+
+---
+
+## 📧 Email Format
+
+**Subject:** `[Example Express App] 🚨 Critical: High Error Rate`
+
+**Content:**
+- Message: Detailed description
+- Application: Example Express App (v1.0.0)
+- Environment: development/production
+- Hostname: Your computer name
+- Time: When it happened
+- Details: Specific metrics
+
+---
+
+## 🔧 Troubleshooting
+
+**Not receiving emails?**
+
+1. ✅ Check .env file has correct App Password
+2. ✅ Restart the server after updating .env
+3. ✅ Visit http://localhost:3001/api/notify-test
+4. ✅ Check spam folder
+5. ✅ Verify 2-Step Verification is enabled on Gmail
+
+**Still not working?**
+
+Check server console for:
+- "Email notifier initialized successfully" ✅
+- OR "Email transporter verification failed" ❌
+
+---
+
+## 📚 Full Documentation
+
+See: `EMAIL_SETUP_GUIDE.md` for complete details.
+
+---
+
+## 🎯 You're Done!
+
+Once setup is complete, you'll automatically receive emails for:
+- ✅ Server errors
+- ✅ API failures
+- ✅ Performance issues
+- ✅ System alerts
+
+**No manual intervention needed!** 🚀
+