Common Issues & Solutions
Quick solutions to frequently encountered problems
🔐 Authentication Issues
Login Problems
❌ Issue: "Invalid credentials" error
Solution:
- Check that Caps Lock is off
- Verify your email address is correct
- Reset your password if needed
- Clear browser cookies and cache
❌ Issue: "Account locked" message
Solution:
- Wait 15 minutes for automatic unlock
- Use "Forgot Password" to reset
- Contact support if issue persists
API Authentication
❌ Issue: "401 Unauthorized" API errors
Solution:
- Verify API key is correct and active
- Check API key permissions
- Ensure API key hasn't expired
- Verify request headers format
🔗 Connection Issues
Data Source Connections
❌ Issue: "Connection timeout" error
Solution:
- Check network connectivity
- Verify firewall settings
- Check if database server is running
- Verify connection string parameters
- Test connection from another machine
❌ Issue: "Access denied" database error
Solution:
- Verify username and password
- Check database user permissions
- Ensure database exists and is accessible
- Check IP whitelist if applicable
API Connectivity
❌ Issue: "Network error" or "Connection refused"
Solution:
- Check internet connection
- Verify API endpoint URL
- Check corporate proxy settings
- Test with curl or Postman
📊 Data Issues
Data Loading Problems
❌ Issue: "Data source not found" error
Solution:
- Refresh data source list
- Check if data source was deleted
- Verify user permissions
- Reconnect to data source
❌ Issue: "Schema validation failed" error
Solution:
- Check data format consistency
- Verify column data types
- Look for missing required fields
- Check for data corruption
Query Performance
❌ Issue: "Query timeout" or slow performance
Solution:
- Add appropriate indexes to database
- Limit result set size
- Use query optimization hints
- Check database server performance
- Consider materialized views for complex queries
🤖 Machine Learning Issues
Model Training
❌ Issue: "Training job failed" error
Solution:
- Check training data quality
- Verify feature columns exist
- Check for missing values
- Review error logs for specific details
- Reduce model complexity if overfitting
❌ Issue: "Insufficient memory" during training
Solution:
- Reduce batch size
- Use data sampling for large datasets
- Enable gradient checkpointing
- Consider distributed training
Model Deployment
❌ Issue: "Model not found" error
Solution:
- Verify model ID is correct
- Check if model was deleted
- Ensure model is in "deployed" state
- Check user permissions
⚡ Workflow Issues
Workflow Execution
❌ Issue: "Workflow step failed" error
Solution:
- Check step configuration
- Verify input data availability
- Check step dependencies
- Review error logs for specific details
- Test step in isolation
❌ Issue: "Workflow stuck" or hanging
Solution:
- Check resource availability
- Verify external service connectivity
- Check for infinite loops in logic
- Restart workflow execution
- Contact support if persistent
📱 User Interface Issues
Browser Problems
❌ Issue: "Page not loading" or blank screen
Solution:
- Clear browser cache and cookies
- Try incognito/private browsing mode
- Update browser to latest version
- Check browser console for errors
- Try different browser
❌ Issue: "Feature not working" or buttons unresponsive
Solution:
- Refresh the page
- Check browser console for JavaScript errors
- Verify user permissions for the feature
- Clear browser cache
- Try different browser
🔧 System Issues
Performance Problems
❌ Issue: "System slow" or unresponsive
Solution:
- Check system resource usage
- Close unnecessary browser tabs
- Clear browser cache
- Check for background processes
- Restart browser
Storage Issues
❌ Issue: "Storage full" or "Quota exceeded"
Solution:
- Delete unused projects or datasets
- Archive old data
- Clean up temporary files
- Contact support to increase quota
📞 Getting Additional Help
If the solutions above don't resolve your issue:
🔍 Troubleshooting Guides
Check our detailed troubleshooting guides for specific error types
Error Codes📋 Issue Reporting Checklist
When reporting an issue to support, include the following information:
Essential Information
- Error Message: Exact error text and code
- Steps to Reproduce: Detailed step-by-step process
- Expected vs Actual Behavior: What you expected vs what happened
- Environment Details: Browser, OS, device type
- Account Information: Username (not password)
- Screenshots/Logs: Visual evidence of the issue
- Recent Changes: Any recent changes to your setup