Table of Contents
- 🔧 Complete Guide to Debugging, System Health & Maintenance Tools
- 📋 Table of Contents
- 1. Debug Dashboard Overview
- 2. Live System Health
- 3. Scheduled Tasks & Cron Jobs
- 4. Debug Logging
- 5. Performance Profiling
- 6. Diagnostic Tools
- 7. Error Tracking
- 8. Cache Management
- 9. Database Health
- 10. Troubleshooting Utilities
🔧 Complete Guide to Debugging, System Health & Maintenance Tools #
Master the debug tools to monitor system health, troubleshoot issues, manage scheduled tasks, and optimize AISEOmatic AI’s performance.
This comprehensive guide covers the debug dashboard, live health monitoring, scheduled task management, diagnostic tools, log analysis, performance profiling, and troubleshooting utilities.
📋 Table of Contents #
- Debug Dashboard Overview
- Live System Health
- Scheduled Tasks & Cron Jobs
- Debug Logging
- Performance Profiling
- Diagnostic Tools
- Error Tracking
- Cache Management
- Database Health
- Troubleshooting Utilities
1. Debug Dashboard Overview #
What is the Debug Dashboard? #
The Debug Dashboard is your technical command center for monitoring, diagnosing, and troubleshooting AISEOmatic AI.
Purpose:
- 🔍 Monitor system health in real-time
- 🐛 Identify and fix issues
- ⚡ Optimize performance
- 📊 Track resource usage
- 🛠️ Manage maintenance tasks
Access Location #
WordPress Admin Panel
└── AISEOmatic AI
└── Debug Tools (tab)
Admin Bar Quick Access:
└── Top Admin Bar
└── AISEOmatic
└── System Health
Pro Features:
└── Advanced debugging
└── Performance profiling
└── Extended loggingDashboard Layout #
┌─────────────────────────────────────────────────────────┐
│ 🔧 AISEOmatic Debug & System Health │
├─────────────────────────────────────────────────────────┤
│ │
│ System Status: ✅ All Systems Operational │
│ Last Check: 2 minutes ago │
│ Plugin Version: 1.0.0 │
│ WordPress: 6.4.2 | PHP: 8.1.12 | MySQL: 8.0.31 │
│ │
│ ┌───────────────────────────────────────────────────┐ │
│ │ 🟢 Live Health Indicators │ │
│ ├───────────────────────────────────────────────────┤ │
│ │ Core Plugin: ✅ Operational │ │
│ │ Database: ✅ Connected │ │
│ │ API Endpoints: ✅ Responding │ │
│ │ Cron System: ✅ Running │ │
│ │ Cache System: ✅ Active │ │
│ │ File System: ✅ Writable │ │
│ │ OpenAI (Optional): ⚠️ Not configured │ │
│ └───────────────────────────────────────────────────┘ │
│ │
│ ┌───────────────────────────────────────────────────┐ │
│ │ ⚡ Performance Metrics │ │
│ ├───────────────────────────────────────────────────┤ │
│ │ Memory Usage: 87 MB / 256 MB (34%) │ │
│ │ ━━━━━━━━━░░░░░░░░░░░░░░░ │ │
│ │ │ │
│ │ CPU Usage: 12% (Normal) │ │
│ │ Response Time: 187ms (Good) │ │
│ │ Active Queries: 3 │ │
│ │ Cache Hit Rate: 87% │ │
│ └───────────────────────────────────────────────────┘ │
│ │
│ ┌───────────────────────────────────────────────────┐ │
│ │ 📅 Scheduled Tasks Status │ │
│ ├───────────────────────────────────────────────────┤ │
│ │ Next: Sitemap regeneration in 23 minutes │ │
│ │ Queue: 3 tasks pending │ │
│ │ Last Run: Score recalculation (12 minutes ago) │ │
│ │ [View All Schedules] │ │
│ └───────────────────────────────────────────────────┘ │
│ │
│ [View Logs] [Run Diagnostics] [Clear Caches] │
│ │
└─────────────────────────────────────────────────────────┘2. Live System Health #
Health Check Components #
Real-Time Monitoring:
┌─────────────────────────────────────────┐
│ System Health Status │
├─────────────────────────────────────────┤
│ │
│ 🟢 Core Systems │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
│ │
│ Plugin Status: │
│ ├─ Version: 1.0.0 ✅ │
│ ├─ Database: Connected ✅ │
│ ├─ Tables: All present ✅ │
│ ├─ Settings: Valid ✅ │
│ └─ License: Active (Pro) ✅ │
│ │
│ WordPress Environment: │
│ ├─ Version: 6.4.2 ✅ (Latest) │
│ ├─ PHP: 8.1.12 ✅ (Recommended) │
│ ├─ MySQL: 8.0.31 ✅ │
│ ├─ Memory Limit: 256M ✅ │
│ └─ Max Execution: 300s ✅ │
│ │
│ File System: │
│ ├─ Plugin Dir: Writable ✅ │
│ ├─ Uploads Dir: Writable ✅ │
│ ├─ Output Dir: Writable ✅ │
│ └─ Permissions: Correct ✅ │
│ │
│ Network Connectivity: │
│ ├─ Outbound HTTPS: Working ✅ │
│ ├─ DNS Resolution: Working ✅ │
│ ├─ API Endpoints: Accessible ✅ │
│ └─ Firewall: Configured ✅ │
│ │
└─────────────────────────────────────────┘
┌─────────────────────────────────────────┐
│ ⚠️ Warnings & Recommendations │
├─────────────────────────────────────────┤
│ │
│ ⚠️ OpenAI API Key not configured │
│ Impact: AI summaries disabled │
│ Action: Add key to enable summaries │
│ Priority: Low (Optional feature) │
│ │
│ ⚠️ Cache hit rate below 90% │
│ Impact: Slightly slower performance │
│ Action: Consider optimizing queries │
│ Priority: Low (Performance tweak) │
│ │
│ [View All Recommendations] │
│ │
└─────────────────────────────────────────┘Critical Issues Detection #
┌─────────────────────────────────────────┐
│ 🔴 Critical Issues (If Any) │
├─────────────────────────────────────────┤
│ │
│ ❌ Database Connection Failed │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
│ Detected: 5 minutes ago │
│ Impact: Plugin non-functional │
│ Error: Can't connect to MySQL │
│ │
│ Troubleshooting Steps: │
│ 1. Check database credentials │
│ 2. Verify MySQL service running │
│ 3. Check firewall rules │
│ 4. Review error logs │
│ │
│ [View Error Details] │
│ [Run Auto-Repair] │
│ [Contact Support] │
│ │
└─────────────────────────────────────────┘Resource Monitoring #
┌─────────────────────────────────────────┐
│ Resource Usage (Real-Time) │
├─────────────────────────────────────────┤
│ │
│ Memory Usage: │
│ Current: 87 MB / 256 MB (34%) │
│ ━━━━━━━━━░░░░░░░░░░░░░░ │
│ Peak: 124 MB │
│ Average: 93 MB │
│ Status: ✅ Normal │
│ │
│ CPU Usage (Last 5 min): │
│ Current: 12% │
│ ▓▓▓░░░░░░░░░░░░░░░░░░░░ │
│ Peak: 34% │
│ Average: 15% │
│ Status: ✅ Normal │
│ │
│ Database Queries: │
│ Active: 3 queries │
│ Queued: 0 queries │
│ Avg Time: 12ms │
│ Slowest: 45ms (acceptable) │
│ Status: ✅ Optimal │
│ │
│ Disk I/O: │
│ Read: 234 KB/s │
│ Write: 87 KB/s │
│ Wait Time: 2ms │
│ Status: ✅ Good │
│ │
└─────────────────────────────────────────┘3. Scheduled Tasks & Cron Jobs #
Cron System Overview #
┌─────────────────────────────────────────┐
│ Scheduled Tasks Management │
├─────────────────────────────────────────┤
│ │
│ WordPress Cron: ✅ Active │
│ System Cron: ⚠️ Recommended (optional) │
│ Last Execution: 12 minutes ago │
│ Next Execution: 23 minutes │
│ │
│ Active Schedules: │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
│ │
│ Task Name Frequency Next │
│ ───────────────────────────────────── │
│ Sitemap Regen Hourly 23m │
│ Score Recalculation Daily 11h │
│ Bot Log Cleanup Weekly 3d │
│ Cache Purge 6 Hours 2h │
│ Health Check 15 Min 8m │
│ Database Optimization Weekly 5d │
│ │
│ [View Full Schedule] │
│ [Add Custom Task] │
│ [Run Task Now] │
│ │
└─────────────────────────────────────────┘Individual Task Details #
┌─────────────────────────────────────────┐
│ Task: AI Sitemap Regeneration │
├─────────────────────────────────────────┤
│ │
│ Status: ✅ Active │
│ Schedule: Every hour │
│ Next Run: In 23 minutes │
│ Last Run: 37 minutes ago (Success) │
│ │
│ Execution History: │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
│ 2025-12-13 10:23 ✅ Success (2.3s) │
│ 2025-12-13 09:23 ✅ Success (2.1s) │
│ 2025-12-13 08:23 ✅ Success (2.5s) │
│ 2025-12-13 07:23 ✅ Success (2.2s) │
│ 2025-12-13 06:23 ✅ Success (2.4s) │
│ │
│ Performance: │
│ Avg Duration: 2.3 seconds │
│ Success Rate: 100% (30 days) │
│ Resource Usage: Low │
│ │
│ Configuration: │
│ Priority: High │
│ Timeout: 60 seconds │
│ Retry on Fail: Yes (3 attempts) │
│ │
│ [Run Now] [Disable] [Edit Schedule] │
│ │
└─────────────────────────────────────────┘Custom Schedule Creation #
┌─────────────────────────────────────────┐
│ Create Custom Scheduled Task │
├─────────────────────────────────────────┤
│ │
│ Task Name: │
│ [Custom Optimization Task ] │
│ │
│ Action: │
│ [Recalculate Scores ▼] │
│ • Recalculate AI Scores │
│ • Regenerate Sitemaps │
│ • Clear Specific Cache │
│ • Database Cleanup │
│ • Custom Hook │
│ │
│ Schedule: │
│ ● Interval │
│ ○ Specific Time │
│ ○ Cron Expression │
│ │
│ Frequency: [Every 6 Hours ▼] │
│ • Every 15 minutes │
│ • Hourly │
│ • Every 6 hours │
│ • Daily │
│ • Weekly │
│ • Monthly │
│ │
│ Target: │
│ ☑ All posts │
│ ☐ Specific post types │
│ ☐ Posts with score < 70 │
│ ☐ Posts older than 30 days │
│ │
│ [Create Task] [Cancel] │
│ │
└─────────────────────────────────────────┘4. Debug Logging #
Log Viewer #
┌─────────────────────────────────────────────────────────┐
│ Debug Logs │
├─────────────────────────────────────────────────────────┤
│ │
│ Level: [All ▼] Category: [All ▼] Date: [Today ▼] │
│ │
│ Timestamp Level Category Message │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
│ 2025-12-13 11:47 INFO Core Plugin init │
│ 2025-12-13 11:47 DEBUG Sitemap Generated XML │
│ 2025-12-13 11:46 INFO Score Calculated P123 │
│ 2025-12-13 11:45 WARNING Cache Low hit rate │
│ 2025-12-13 11:44 INFO Bot GPTBot detected │
│ 2025-12-13 11:43 DEBUG API OpenAI called │
│ 2025-12-13 11:42 ERROR Database Slow query 230ms│
│ 2025-12-13 11:41 INFO Cron Hourly task run │
│ 2025-12-13 11:40 DEBUG Cache Cleared old data│
│ 2025-12-13 11:39 INFO Core Settings saved │
│ │
│ Showing 1-10 of 1,247 entries │
│ [Previous] [1] [2] [3] ... [125] [Next] │
│ │
│ [Export Logs] [Clear Old Logs] [Download All] │
│ │
└─────────────────────────────────────────────────────────┘Log Levels & Categories #
Log Levels:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔴 ERROR - Critical issues requiring attention
⚠️ WARNING - Potential problems, not critical
ℹ️ INFO - General operational information
🔍 DEBUG - Detailed diagnostic information
Categories:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Core - Plugin initialization, settings
Sitemap - AI Sitemap generation
Score - AI Score calculations
Bot - Bot detection & logging
Cache - Caching operations
Database - Database queries & optimization
API - External API calls (OpenAI, etc.)
Cron - Scheduled task execution
Optimization- Content optimization processes
Error - Error handling & recoveryLog Configuration #
┌─────────────────────────────────────────┐
│ Debug Logging Settings │
├─────────────────────────────────────────┤
│ │
│ ☑ Enable debug logging │
│ │
│ Log Level: │
│ ● INFO and above (Recommended) │
│ ○ WARNING and above │
│ ○ ERROR only │
│ ○ DEBUG (Verbose - for developers) │
│ │
│ Log Categories: │
│ ☑ Core operations │
│ ☑ Database queries │
│ ☑ API calls │
│ ☑ Cache operations │
│ ☐ Detailed debug (Very verbose) │
│ │
│ Storage: │
│ Location: /wp-content/debug.log │
│ Max Size: [10] MB │
│ Retention: [30] days │
│ Auto-cleanup: ☑ Enabled │
│ │
│ Performance: │
│ ☐ Log slow queries (>100ms) │
│ ☐ Log memory usage │
│ ☐ Profile execution time │
│ │
│ [Save Settings] │
│ │
└─────────────────────────────────────────┘5. Performance Profiling #
Execution Time Tracking #
┌─────────────────────────────────────────┐
│ Performance Profile (Last 100 Requests)│
├─────────────────────────────────────────┤
│ │
│ Average Response Time: 187ms │
│ Median: 165ms │
│ 95th Percentile: 340ms │
│ 99th Percentile: 520ms │
│ │
│ Breakdown: │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
│ WordPress Core: 45ms (24%) │
│ Database Queries: 67ms (36%) │
│ AISEOmatic Logic: 52ms (28%) │
│ External APIs: 18ms (10%) │
│ Other: 5ms (2%) │
│ │
│ Slowest Operations: │
│ 1. AI Score Calc: 89ms avg │
│ 2. Sitemap Gen: 67ms avg │
│ 3. Bot Lookup: 34ms avg │
│ 4. Cache Check: 12ms avg │
│ 5. Settings Load: 8ms avg │
│ │
│ [View Detailed Profile] │
│ [Export Data] │
│ │
└─────────────────────────────────────────┘Query Analysis #
┌─────────────────────────────────────────┐
│ Database Query Performance │
├─────────────────────────────────────────┤
│ │
│ Total Queries: 47 (Last page load) │
│ Total Time: 67ms │
│ Average: 1.4ms per query │
│ │
│ Slow Queries (>50ms): │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
│ │
│ 1. SELECT * FROM wp_aiseoai_scores │
│ WHERE post_id IN (...) │
│ Time: 78ms │
│ Rows: 150 │
│ Solution: Add index on post_id │
│ │
│ 2. SELECT * FROM wp_aiseoai_bots │
│ ORDER BY visit_time DESC │
│ Time: 62ms │
│ Rows: 1000 │
│ Solution: Limit results, add cache │
│ │
│ Recommendations: │
│ • Add missing indexes │
│ • Enable query cache │
│ • Optimize large result sets │
│ │
│ [Run Database Optimization] │
│ │
└─────────────────────────────────────────┘6. Diagnostic Tools #
System Diagnostics #
┌─────────────────────────────────────────┐
│ Run System Diagnostics │
├─────────────────────────────────────────┤
│ │
│ Select Tests to Run: │
│ ☑ Core plugin integrity │
│ ☑ Database connectivity │
│ ☑ File system permissions │
│ ☑ API endpoints │
│ ☑ Cron system │
│ ☑ Cache functionality │
│ ☑ Plugin conflicts │
│ ☐ OpenAI connection (if configured) │
│ │
│ [Run Diagnostics] │
│ │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
│ │
│ Last Run: 2025-12-13 10:30 │
│ Results: ✅ All tests passed │
│ Duration: 3.2 seconds │
│ │
│ [View Last Results] │
│ [Schedule Regular Tests] │
│ │
└─────────────────────────────────────────┘Diagnostic Results #
┌─────────────────────────────────────────┐
│ Diagnostic Results │
├─────────────────────────────────────────┤
│ │
│ ✅ Core Plugin Integrity │
│ All files present and uncorrupted │
│ Version: 1.0.0 │
│ Checksum: Valid │
│ │
│ ✅ Database Connectivity │
│ Connection: Successful │
│ Tables: All present (4/4) │
│ Indexes: Optimized │
│ │
│ ✅ File System Permissions │
│ Plugin directory: Writable │
│ Uploads directory: Writable │
│ Cache directory: Writable │
│ │
│ ✅ API Endpoints │
│ /wp-json/aiseoai/v1/*: Accessible │
│ Response time: 45ms (Good) │
│ Authentication: Working │
│ │
│ ✅ Cron System │
│ WordPress Cron: Active │
│ Scheduled tasks: 6 active │
│ Last execution: On time │
│ │
│ ⚠️ Cache Functionality │
│ Object cache: Working │
│ Hit rate: 83% (Below 90% target) │
│ Recommendation: Review cache strategy │
│ │
│ [Export Report] [Email to Admin] │
│ │
└─────────────────────────────────────────┘7. Error Tracking #
Error Dashboard #
┌─────────────────────────────────────────┐
│ Error Tracking (Last 7 Days) │
├─────────────────────────────────────────┤
│ │
│ Total Errors: 12 │
│ Critical: 0 │
│ Warnings: 12 │
│ │
│ Error Trend: │
│ Mon Tue Wed Thu Fri Sat Sun │
│ 3 2 1 2 1 2 1 │
│ ▓▓ ▓ ░ ▓ ░ ▓ ░ │
│ │
│ Recent Errors: │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
│ │
│ 2025-12-13 11:42 WARNING │
│ Slow database query detected │
│ Query took 230ms (threshold: 100ms) │
│ Location: Score calculation │
│ [View Details] │
│ │
│ 2025-12-12 15:23 WARNING │
│ Cache miss rate high │
│ Hit rate: 78% (target: 90%) │
│ Location: Sitemap generation │
│ [View Details] │
│ │
│ [View All Errors] [Clear Error Log] │
│ │
└─────────────────────────────────────────┘8. Cache Management #
Cache Control Panel #
┌─────────────────────────────────────────┐
│ Cache Management │
├─────────────────────────────────────────┤
│ │
│ Cache Status: ✅ Active │
│ Hit Rate: 87% (Good) │
│ Total Size: 23.4 MB │
│ Entries: 1,247 │
│ │
│ Cache Types: │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
│ │
│ Object Cache: │
│ Size: 12.3 MB │
│ Entries: 567 │
│ Hit Rate: 91% │
│ [Clear Object Cache] │
│ │
│ Transient Cache: │
│ Size: 8.7 MB │
│ Entries: 432 │
│ Hit Rate: 85% │
│ [Clear Transients] │
│ │
│ Database Cache: │
│ Size: 2.4 MB │
│ Entries: 248 │
│ Hit Rate: 82% │
│ [Clear DB Cache] │
│ │
│ Operations: │
│ [Clear All Caches] │
│ [Warm Up Cache] │
│ [View Cache Stats] │
│ │
└─────────────────────────────────────────┘9. Database Health #
Database Optimization #
┌─────────────────────────────────────────┐
│ Database Health & Optimization │
├─────────────────────────────────────────┤
│ │
│ Tables Status: │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
│ │
│ wp_aiseoai_scores │
│ Rows: 150 | Size: 2.3 MB | ✅ Optimal │
│ Last optimized: 3 days ago │
│ [Optimize Now] │
│ │
│ wp_aiseoai_bots │
│ Rows: 1,247 | Size: 5.7 MB | ✅ Good │
│ Last optimized: 2 days ago │
│ [Optimize Now] │
│ │
│ wp_aiseoai_cache │
│ Rows: 432 | Size: 1.2 MB | ⚠️ Bloated │
│ Last optimized: 15 days ago │
│ Recommendation: Clean old entries │
│ [Optimize Now] [Clean Old Data] │
│ │
│ Overall Health: ✅ Good │
│ Total Size: 9.2 MB │
│ Fragmentation: Low │
│ │
│ [Optimize All Tables] │
│ [Schedule Auto-Optimization] │
│ │
└─────────────────────────────────────────┘10. Troubleshooting Utilities #
Quick Fix Tools #
┌─────────────────────────────────────────┐
│ Quick Fix Utilities │
├─────────────────────────────────────────┤
│ │
│ 🔧 Common Issues │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
│ │
│ Reset Plugin Settings │
│ Restore factory defaults │
│ ⚠️ Warning: All settings will be lost │
│ [Reset Settings] │
│ │
│ Rebuild Database Tables │
│ Recreate all AISEOmatic tables │
│ Use if tables corrupted │
│ [Rebuild Tables] │
│ │
│ Clear All Caches │
│ Remove all cached data │
│ Safe to run anytime │
│ [Clear Caches] │
│ │
│ Flush Rewrite Rules │
│ Fix permalink/sitemap issues │
│ Run if sitemap not accessible │
│ [Flush Rules] │
│ │
│ Regenerate AI Sitemap │
│ Force immediate sitemap rebuild │
│ Use after bulk content changes │
│ [Regenerate Sitemap] │
│ │
│ Recalculate All AI Scores │
│ Recompute scores for all content │
│ ⚠️ Resource intensive │
│ [Recalculate Scores] │
│ │
│ Test OpenAI Connection │
│ Verify API key and connectivity │
│ (Only if OpenAI configured) │
│ [Test Connection] │
│ │
└─────────────────────────────────────────┘System Information Export #
Export System Information:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Generate comprehensive system report
for support or documentation:
Includes:
✅ Plugin version & settings
✅ WordPress environment
✅ Server configuration
✅ Active plugins list
✅ Theme information
✅ Error logs (last 100)
✅ Performance metrics
✅ Health check results
Format: [Text File ▼]
- Plain text (.txt)
- JSON (.json)
- HTML Report (.html)
Privacy: ⚠️ May contain sensitive info
Review before sharing
[Generate Report]
[Generate & Download]
[Generate & Email to Support]AISEOmatic Debug Tools Guide v1.0
Last Updated: December 13, 2025
