Diagnostics¶
System health checks and diagnostic tools for troubleshooting.
Diagnostics provides detailed system health information, connection testing, and performance metrics to identify and resolve system issues.
Navigation: Admin → Tools → Diagnostics
System Health Dashboard¶
Overall System Status¶
Shows system status at a glance:
- System Status - Green (healthy), Yellow (warning), Red (critical)
- Last Check - When last health check ran
- Components - Individual component status
- Performance - System performance metrics
Connection Tests¶
Database Connection¶
Tests connection to primary database:
- Status - Connected/Disconnected
- Response Time - Query execution time
- Version - Database version
- Records - Total records in key tables
To test: 1. Click Test Database Connection 2. Wait for result 3. If failed, check network/server
Server Connectivity¶
Tests connection to backend server:
- Status - Online/Offline
- Response Time - API response time
- Version - Server version
- Uptime - How long server running
Payment Gateway Connection¶
Tests payment processor connectivity (if configured):
- Status - Connected/Disconnected
- Response Time - Gateway response time
- Last Transaction - Time of last payment attempt
- Test Payment - Optional test transaction
Email Configuration¶
Tests email provider connectivity:
- Provider - Configured provider (SMTP/Gmail/Office365)
- Status - Connected/Disconnected
- Last Send - Time of last email sent
- Queue Status - Pending/failed email count
Performance Metrics¶
System Performance¶
- CPU Usage - Current CPU utilization
- Memory - RAM usage and available
- Disk Space - Storage usage
- Database Size - Database storage used
Response Times¶
- API Response - Average API response time
- Database Query - Average query time
- Email Processing - Email send time
- Payment Processing - Payment authorization time
Transaction Stats¶
- Daily Transactions - Today's transaction count
- Average Sale - Average transaction amount
- Concurrent Users - Currently logged-in users
- Session Count - Active sessions
Health Indicators¶
Green (Healthy)¶
System operating normally: - All connections active - Response times good - No errors or warnings - Sufficient disk/memory
Yellow (Warning)¶
Minor issues detected: - Slow response times - High CPU/memory usage - Mail queue backing up - Payment retries occurring
Action: Monitor and investigate
Red (Critical)¶
Serious issues: - Connection failures - Out of disk space - Payment gateway down - Database unavailable
Action: Investigate immediately
Diagnostics Reports¶
Generate Full Report¶
Create comprehensive diagnostic report:
- Click Generate Diagnostic Report
- Select report type (System/Database/Payment/Email)
- Wait for report generation
- Review results
- Export if needed
Export Diagnostics¶
Download diagnostic data for support:
- Click Export Diagnostics
- Receives compressed file
- Share with support for analysis
- Includes logs, config, metrics
Troubleshooting with Diagnostics¶
Database Issues¶
- Run Diagnostics
- Check Database Connection status
- Review response times
- Check disk space
- If offline: Verify server/network/firewall
Payment Problems¶
- Check Payment Gateway Connection
- Review response time
- Check recent payment attempts (Payment Attempts tool)
- Test payment if available
- Review payment processor status
Email Problems¶
- Check Email Configuration test
- Verify provider connection
- Check queue status (retry count)
- Use Email Testing tool
- Review email logs
Performance Issues¶
- Review Performance Metrics
- Check CPU/memory usage
- Review query times
- Monitor concurrent users
- Check disk space s