> ## Documentation Index > Fetch the complete documentation index at: https://docs.cloudnosys.com/llms.txt > Use this file to discover all available pages before exploring further. # Troubleshooting Guide > Comprehensive troubleshooting guide for common Cloudnosys issues This comprehensive troubleshooting guide helps you resolve common issues when using Cloudnosys. If you encounter problems during setup, scanning, or daily operations, this guide provides step-by-step solutions. ## Common Setup Issues ### Account Connection Problems **Issue: Cannot Connect to AWS Account** **Symptoms:** * Error messages when trying to connect AWS account * CloudFormation stack deployment failures * Permission denied errors **Solutions:** **Verify AWS Credentials** ```bash theme={null} aws sts get-caller-identity ``` * Ensure you're logged in with the correct AWS account * Verify that your AWS credentials have sufficient permissions **Check IAM Permissions** * Ensure your AWS user has permissions to create IAM roles * Verify CloudFormation permissions * Check for any service control policies (SCPs) that might block access **CloudFormation Template Issues** * Download the latest CloudFormation template from Cloudnosys * Ensure the template is valid and complete * Check for any region-specific restrictions **Network Connectivity** * Verify internet connectivity * Check for firewall restrictions * Ensure AWS endpoints are accessible **Issue: Cannot Connect to GCP Account** **Symptoms:** * OAuth authentication failures * Permission denied errors * Service account creation issues **Solutions:** **Verify Google Account Access** * Ensure you're logged in with the correct Google account * Verify that the account has access to the GCP projects * Check for any organizational policies that might restrict access **Check GCP Permissions** * Ensure the account has necessary IAM permissions * Verify project access permissions * Check for any organization policies that might block access **OAuth Configuration** * Clear browser cache and cookies * Try using an incognito/private browser window * Ensure pop-up blockers are disabled **Service Account Issues** * Verify that service accounts can be created * Check for any quota limits * Ensure proper project permissions ### Permission Issues **Issue: Insufficient Permissions** **Symptoms:** * "Access Denied" errors * Scan failures due to permission issues * Incomplete scan results **Solutions:** **AWS Permission Issues** ```json theme={null} { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iam:GetRole", "iam:ListRoles", "ec2:Describe*", "s3:GetBucketLocation", "s3:ListAllMyBuckets" ], "Resource": "*" } ] } ``` **GCP Permission Issues** Ensure the service account has the following roles: * Security Center Admin * Compute Viewer * Storage Viewer * IAM Security Reviewer **Cross-Account Access** * Verify trust relationships between accounts * Check for any cross-account restrictions * Ensure proper role assumptions ### Network Connectivity Issues **Issue: Cannot Access Cloud Resources** **Symptoms:** * Timeout errors during scanning * Incomplete resource discovery * Network-related scan failures **Solutions:** **VPC Configuration** * Ensure proper VPC configuration * Check security group rules * Verify subnet accessibility **Firewall Rules** * Check firewall rules that might block access * Ensure necessary ports are open * Verify network ACLs **DNS Resolution** * Verify DNS configuration * Check for DNS resolution issues * Ensure proper domain name resolution ## Scan-Related Issues ### Scan Failures **Issue: Scan Fails to Start** **Symptoms:** * Scan status shows "Failed" * Error messages in scan logs * No scan results generated **Solutions:** **Check Resource Access** * Verify that Cloudnosys can access all required resources * Check for any resource-specific restrictions * Ensure proper permissions for all resource types **Service Limits** * Check for any cloud service limits * Verify quota availability * Request limit increases if necessary **Network Issues** * Verify network connectivity * Check for any network restrictions * Ensure proper routing configuration **Issue: Incomplete Scan Results** **Symptoms:** * Missing resources in scan results * Partial scan coverage * Inconsistent scan results **Solutions:** **Resource Discovery** * Verify that all resources are discoverable * Check for any resource-specific access issues * Ensure proper tagging and labeling **Permission Scope** * Verify that permissions cover all required resources * Check for any permission gaps * Ensure consistent permission application **Scan Configuration** * Review scan configuration settings * Verify resource selection criteria * Check for any configuration issues ### Performance Issues **Issue: Slow Scan Performance** **Symptoms:** * Scans take longer than expected * Timeout errors during scanning * Resource exhaustion during scans **Solutions:** **Resource Optimization** * Optimize scan scope to focus on critical resources * Use incremental scanning where possible * Schedule scans during low-usage periods **Network Optimization** * Optimize network configuration * Use appropriate network bandwidth * Ensure proper network routing **Service Limits** * Check for any service rate limits * Implement appropriate throttling * Request limit increases if necessary ## Advanced Features Issues ### Real-time Monitoring Issues **Issue: EagleEye Not Working** **Symptoms:** * No real-time alerts generated * EagleEye status shows "Inactive" * Missing threat detection capabilities **Solutions:** **Deployment Verification** * Verify that EagleEye resources are properly deployed * Check for any deployment errors * Ensure proper resource configuration **Permission Issues** * Verify that EagleEye has necessary permissions * Check for any permission restrictions * Ensure proper role assignments **Network Configuration** * Verify network configuration for EagleEye * Check for any network restrictions * Ensure proper connectivity **Issue: CloudXray Not Scanning** **Symptoms:** * No vulnerability scan results * CloudXray status shows "Inactive" * Missing malware detection capabilities **Solutions:** **Resource Deployment** * Verify that CloudXray resources are properly deployed * Check for any deployment errors * Ensure proper resource configuration **Scan Configuration** * Verify CloudXray scan configuration * Check for any configuration issues * Ensure proper scan scope **Permission Issues** * Verify that CloudXray has necessary permissions * Check for any permission restrictions * Ensure proper role assignments ## Data and Privacy Issues ### Data Access Issues **Issue: Cannot Access Scan Results** **Symptoms:** * Dashboard shows no data * Scan results not visible * Access denied to results **Solutions:** **Permission Verification** * Verify that you have access to scan results * Check for any permission restrictions * Ensure proper role assignments **Data Retention** * Check data retention policies * Verify that data hasn't expired * Ensure proper data storage **Browser Issues** * Clear browser cache and cookies * Try using a different browser * Check for any browser-specific issues ### Privacy and Compliance Issues **Issue: Data Privacy Concerns** **Symptoms:** * Concerns about data handling * Compliance questions * Privacy policy questions **Solutions:** **Data Handling** * Review Cloudnosys data handling policies * Understand data collection and storage practices * Verify compliance with privacy regulations **Compliance Verification** * Check compliance certifications * Verify adherence to security standards * Ensure proper compliance reporting **Data Retention** * Understand data retention policies * Verify data deletion procedures * Ensure proper data lifecycle management ## Getting Help ### Self-Service Resources **Documentation** * Review Cloudnosys documentation * Check for updated guides and tutorials * Look for specific issue documentation **Community Forums** * Search community forums for similar issues * Post questions in community forums * Share solutions with the community **Knowledge Base** * Search the knowledge base for solutions * Check for known issues and solutions * Review best practices and recommendations ### Contacting Support **Support Channels** * Email support for technical issues * Live chat for immediate assistance * Phone support for urgent issues **Information to Provide** * Detailed description of the issue * Steps to reproduce the problem * Error messages and logs * System configuration details **Response Times** * **Critical issues**: Within 4 hours * **High priority issues**: Within 24 hours * **General issues**: Within 48 hours ### Escalation Process **Level 1 Support** * Initial issue assessment * Basic troubleshooting * Documentation and guidance **Level 2 Support** * Advanced troubleshooting * Technical analysis * Custom solutions **Level 3 Support** * Engineering team involvement * Product development feedback * Long-term solutions ## Prevention and Best Practices ### Proactive Monitoring **Regular Health Checks** * Monitor system health regularly * Check for any performance issues * Verify proper functionality **Configuration Management** * Maintain proper configuration * Document configuration changes * Implement change management **Security Best Practices** * Follow security best practices * Implement proper access controls * Regular security assessments ### Maintenance and Updates **Regular Updates** * Keep systems updated * Apply security patches * Monitor for updates **Backup and Recovery** * Implement proper backup procedures * Test recovery procedures * Maintain disaster recovery plans **Performance Optimization** * Monitor performance metrics * Optimize system configuration * Implement performance improvements ## Conclusion This troubleshooting guide provides comprehensive solutions for common Cloudnosys issues. By following these guidelines and best practices, you can resolve most issues independently and maintain optimal system performance. For issues not covered in this guide, don't hesitate to contact our support team for assistance. We're committed to helping you succeed with Cloudnosys and maintaining the security of your cloud environment.