System Diagnostics

Complete guide to system diagnostics and health checks in LuaBeans - Community Manager.

Overview

URL: /admin/diagnostics

Access: Admin only

Purpose: Monitor system health and diagnose issues

Features

System Health

View system status:

• Database connection

• Discord API connection

• Bot connection status

• System uptime

Configuration Validation

Check configuration:

• Environment variables

• Required settings

• API credentials

• Database settings

Service Status

Monitor services:

• Web panel status

• Discord bot status

• Database server status

• External API status

Usage

Accessing Diagnostics

1. Go to Admin → Diagnostics

2. View system health overview

3. Check individual service status

4. Review configuration validation

Running Diagnostics

Diagnostics run automatically:

• System checks run on page load

• Status updates in real-time

• Warnings shown for issues

Manual Refresh

Refresh diagnostics:

1. Click Refresh button

2. Wait for checks to complete

3. Review updated status

Diagnostic Checks

Database Connection

Checks:

• Database connectivity

• Connection pool status

• Query execution

• Table existence

Status Indicators:

• ✅ Connected - Database is accessible

• ⚠️ Warning - Connection issues detected

• ❌ Failed - Cannot connect to database

Discord API Connection

Checks:

• Discord API accessibility

• OAuth2 credentials

• Bot token validity

• Guild access

Status Indicators:

• ✅ Connected - Discord API accessible

• ⚠️ Warning - API issues detected

• ❌ Failed - Cannot connect to Discord API

Bot Connection

Checks:

• Bot online status

• Bot permissions

• Command registration

• Event handlers

Status Indicators:

• ✅ Connected - Bot is online and responding

• ⚠️ Warning - Bot has issues

• ❌ Failed - Bot is offline or not responding

Configuration Validation

Checks:

• Required environment variables

• Valid configuration values

• API credentials format

• Database settings

Status Indicators:

• ✅ Valid - All required settings present

• ⚠️ Warning - Some settings missing or invalid

• ❌ Invalid - Critical settings missing

Health Status

System Health Overview

Overall system status:

• Healthy - All systems operational

• Degraded - Some issues detected

• Down - Critical systems unavailable

Service Status

Individual service status:

• Operational - Service is working

• Degraded - Service has issues

• Down - Service is unavailable

Error Reporting

Error Logs

View recent errors:

• Error messages

• Timestamps

• Affected services

• Error details

Warning Logs

View recent warnings:

• Warning messages

• Timestamps

• Affected services

• Warning details

Troubleshooting

Database Connection Failed

Issue: Database diagnostic fails

Solutions:

1. Verify database is running

2. Check database credentials in .env

3. Verify network connectivity

4. Check firewall rules

5. Review database logs

Discord API Connection Failed

Issue: Discord API diagnostic fails

Solutions:

1. Verify Discord API is accessible

2. Check API credentials in .env

3. Verify OAuth2 application exists

4. Check bot token is valid

5. Review Discord API status

Bot Connection Failed

Issue: Bot diagnostic fails

Solutions:

1. Verify bot is running

2. Check bot token in .env

3. Verify bot is online in Discord

4. Check bot has required permissions

5. Review bot logs

Related Documentation

• Admin Dashboard

• Debugging Guide

• Configuration