Troubleshooting

Common issues and solutions for Devhelion Tutor analytics collection

Quick Diagnosis

Start with Devhelion status to check system health, then use Devhelion logs to monitor real-time activity.

Data Collection Issues

Tutor Not Collecting Data

Symptoms:

Analytics dashboard shows "No data collected"
Using AI tools but no events appear
Devhelion status shows "Collection: Disabled"

Solutions:

1. Enable Collection

Devhelion enable
Devhelion status  # Verify it's enabled

2. Check Authentication

Devhelion login        # Re-authenticate if needed
Devhelion status # Check connection

3. Verify Tool Support

Ensure you're using supported AI tools:

Claude Code (VS Code extension)
Cursor AI
GitHub Copilot
Codeium
Tabnine

Partial Data Collection

Symptoms:

Some tools tracked, others missing
Intermittent data collection
Token counts seem low

Solutions:

# Check which tools are being monitored
Devhelion logs

# Look for tool-specific errors
# Restart collection to refresh tool detection
Devhelion disable
Devhelion enable

Dashboard Access Issues

Cannot Access Analytics Dashboard

Symptoms:

https://Devhelion.ai/Devhelion/analytics shows connection error
"Site can't be reached" browser error
Dashboard loads but shows no data

Solutions:

1. Verify Devhelion is Running

Devhelion status          # Check if Devhelion is running
Devhelion start           # Start if needed

2. Check Port Availability

# Check if port 3000 is in use
lsof -i :3000

# Kill conflicting processes if needed
Devhelion restart

3. Browser Cache Issues

Clear browser cache and hard refresh (Ctrl+Shift+R / Cmd+Shift+R)

Dashboard Shows No Data

Possible Causes:

Tutor collection is disabled
No AI tool usage since enabling
Database connection issues
Time range filter excluding data

Quick Checks:

Devhelion status    # Verify collection is enabled
Devhelion logs      # Watch for new events

# Test by using any AI tool, then refresh dashboard

Authentication Problems

Login Issues

Common Symptoms:

"Authentication failed" errors
"Invalid session" messages
Redirected to login repeatedly

Solutions:

1. Re-authenticate

Devhelion logout
Devhelion login          # Follow OAuth flow

2. Clear Stored Credentials

# Clear cached authentication
rm ~/.Devhelion/credentials
Devhelion login

3. Network/Firewall Issues

Ensure your firewall allows connections to Devhelion.ai and GitHub. Corporate networks may block OAuth flows.

API & Integration Issues

API Key Problems

Symptoms:

401 Unauthorized API responses
"Invalid API key" errors
Rate limiting issues

Solutions:

1. Verify API Key

# Test API key
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://Devhelion.ai/api/data/events

2. Generate New Key

Visit https://Devhelion.ai/settings → API Keys → Generate New Key

3. Check Rate Limits

Default limits: 1000 requests/hour. Contact support for higher limits. See API Reference for details.

Performance Issues

Slow Dashboard or High CPU Usage

Symptoms:

Dashboard takes long to load
High CPU usage from Devhelion processes
System becomes sluggish

Solutions:

1. Check System Resources

# Check Devhelion process usage
ps aux | grep Devhelion

# Monitor resource usage
top -p $(pgrep Devhelion)

2. Reduce Collection Frequency

# Configure lighter collection (if available)
Devhelion config --frequency=low
Devhelion restart

3. Clean Up Old Data

# Archive old analytics (older than 90 days)
Devhelion cleanup --days=90

Advanced Diagnostics

Debug Mode

Enable verbose logging for detailed troubleshooting:

# Enable debug logging
export Devhelion_DEBUG=true
Devhelion logs --debug

# Or start with debug mode
Devhelion enable --debug

System Information

Gather system info for support requests:

# Generate diagnostic report
Devhelion diagnostic >  Devhelion-debug.log

# Check system compatibility
Devhelion doctor

Reset Everything

Nuclear option - complete reset (will lose data):

# ⚠️ WARNING: This deletes all analytics data
Devhelion disable
Devhelion reset --confirm
Devhelion enable

Getting Help

If these solutions don't resolve your issue, here's how to get additional support:

Community Support

Enterprise Support

Before Contacting Support

Please include the output of Devhelion diagnostic andDevhelion status with your support request. This helps us diagnose issues faster.

Related Resources

Getting Started

Complete setup guide and initial configuration.

CLI Commands

Complete reference for all Tutor CLI commands.

API Reference

Programmatic access and integration guides.

Data Collection Issues

Tutor Not Collecting Data

Symptoms:

Analytics dashboard shows "No data collected"
Using AI tools but no events appear
Devhelion status shows "Collection: Disabled"

Solutions:

1. Enable Collection

Devhelion enable
Devhelion status  # Verify it's enabled

2. Check Authentication

Devhelion login        # Re-authenticate if needed
Devhelion status # Check connection

3. Verify Tool Support

Ensure you're using supported AI tools:

Claude Code (VS Code extension)
Cursor AI
GitHub Copilot
Codeium
Tabnine

Partial Data Collection

Symptoms:

Some tools tracked, others missing
Intermittent data collection
Token counts seem low

Solutions:

# Check which tools are being monitored
Devhelion logs

# Look for tool-specific errors
# Restart collection to refresh tool detection
Devhelion disable
Devhelion enable

Dashboard Access Issues

Cannot Access Analytics Dashboard

Symptoms:

https://Devhelion.ai/Devhelion/analytics shows connection error
"Site can't be reached" browser error
Dashboard loads but shows no data

Solutions:

1. Verify Devhelion is Running

Devhelion status          # Check if Devhelion is running
Devhelion start           # Start if needed

2. Check Port Availability

# Check if port 3000 is in use
lsof -i :3000

# Kill conflicting processes if needed
Devhelion restart

3. Browser Cache Issues

Clear browser cache and hard refresh (Ctrl+Shift+R / Cmd+Shift+R)

Dashboard Shows No Data

Possible Causes:

Tutor collection is disabled
No AI tool usage since enabling
Database connection issues
Time range filter excluding data

Quick Checks:

Devhelion status    # Verify collection is enabled
Devhelion logs      # Watch for new events

# Test by using any AI tool, then refresh dashboard

Authentication Problems

Login Issues

Common Symptoms:

"Authentication failed" errors
"Invalid session" messages
Redirected to login repeatedly

Solutions:

1. Re-authenticate

Devhelion logout
Devhelion login          # Follow OAuth flow

2. Clear Stored Credentials

# Clear cached authentication
rm ~/.Devhelion/credentials
Devhelion login

3. Network/Firewall Issues

Ensure your firewall allows connections to Devhelion.ai and GitHub. Corporate networks may block OAuth flows.

API & Integration Issues

API Key Problems

Symptoms:

401 Unauthorized API responses
"Invalid API key" errors
Rate limiting issues

Solutions:

1. Verify API Key

# Test API key
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://Devhelion.ai/api/data/events

2. Generate New Key

Visit https://Devhelion.ai/settings → API Keys → Generate New Key

3. Check Rate Limits

Default limits: 1000 requests/hour. Contact support for higher limits. See API Reference for details.

Performance Issues

Slow Dashboard or High CPU Usage

Symptoms:

Dashboard takes long to load
High CPU usage from Devhelion processes
System becomes sluggish

Solutions:

1. Check System Resources

# Check Devhelion process usage
ps aux | grep Devhelion

# Monitor resource usage
top -p $(pgrep Devhelion)

2. Reduce Collection Frequency

# Configure lighter collection (if available)
Devhelion config --frequency=low
Devhelion restart

3. Clean Up Old Data

# Archive old analytics (older than 90 days)
Devhelion cleanup --days=90

Advanced Diagnostics

Debug Mode

Enable verbose logging for detailed troubleshooting:

# Enable debug logging
export Devhelion_DEBUG=true
Devhelion logs --debug

# Or start with debug mode
Devhelion enable --debug

System Information

Gather system info for support requests:

# Generate diagnostic report
Devhelion diagnostic >  Devhelion-debug.log

# Check system compatibility
Devhelion doctor

Reset Everything

Nuclear option - complete reset (will lose data):

# ⚠️ WARNING: This deletes all analytics data
Devhelion disable
Devhelion reset --confirm
Devhelion enable

Getting Help

If these solutions don't resolve your issue, here's how to get additional support:

Before Contacting Support

Please include the output of Devhelion diagnostic andDevhelion status with your support request. This helps us diagnose issues faster.