4.2 KiB
4.2 KiB
Usage Guide
Search
Basic Search
- Type in the search box (minimum 2 characters)
- Results appear instantly as you type
- Filter by resource type using the buttons: All Resources | EC2 Instances | Security Groups
Regex Search
Enable advanced pattern matching:
- Check the "Regex" box to use regular expressions
- Examples:
^prod-.*-\d+$- Finds names starting with "prod-" and ending with numbers(dev|test|qa)- Finds names containing dev, test, or qa10\.0\.\d+\.\d+- Finds IP addresses in the 10.0.x.x range
View Details
EC2 Instance View
Click on any EC2 instance from search results to view:
- Main card shows EC2 details:
- Instance ID
- Private IP Address
- State (running, stopped, etc.)
- Account ID and Name
- All AWS Tags
- Nested cards show all attached Security Groups with their details
Security Group View
Click on any Security Group from search results to view:
- Main card shows SG details:
- Group ID
- Group Name
- Wave Tag
- Ingress/Egress Rule Counts
- All AWS Tags
- Nested cards show all EC2 instances using this Security Group
View Security Group Rules
When viewing security groups (either attached to an EC2 or directly):
- Click the View Rules button on any security group card
- A modal opens showing all ingress and egress rules
- Switch between Ingress and Egress tabs
- Use the search box to filter rules by protocol, port, source, or description
- Rules are displayed in a compact table format with:
- Protocol (TCP, UDP, ICMP, All)
- Port Range
- Source Type (CIDR, Security Group, Prefix List)
- Source (IP range or SG ID)
- Description
Navigation
- Click ← Back to Search to return to search results
- Perform a new search at any time
- Click outside the rules modal to close it
Export to CSV
SGO provides comprehensive CSV export capabilities in multiple contexts.
Search Results Export
- Click the 💾 Export button in the view controls (top right)
- Exports all current search results with filters applied
- Includes:
- Type (EC2 or Security Group)
- Name
- ID (Instance ID or Group ID)
- Account
- State (for EC2)
- IP Address (for EC2)
- Security Groups count (for EC2)
- Wave
- Git Repository
- Git Organization
- Git File
EC2 Instance Details Export
- Click the 💾 Export button in any EC2 detail card
- Exports complete EC2 information including:
- Instance details (ID, name, state, IP, account info)
- All AWS tags
- Attached security groups with their details
Security Group Details Export
- Click the 💾 Export button in any SG detail card
- Exports complete SG information including:
- Group details (ID, name, wave, rule counts)
- All AWS tags
- Attached EC2 instances with their details
Security Group Rules Export
- Click the 💾 Export button in the rules modal
- Exports all ingress and egress rules with:
- Rule details (direction, protocol, ports, source)
- Group ID and name
- Account ID and name
- Git file and commit information from tags
All exports include timestamps in filenames and proper CSV escaping for safe data handling.
Import and Refresh
Import from AWS
- From the Explorer page, click Change Profiles (or visit
/directly) - Select AWS profiles to import
- Enter MFA/TOTP codes for profiles that require authentication
- Click Start Import for each profile
- Watch real-time progress logs
- Click Done - Go to Explorer when finished
Refresh Data
- Click the Refresh Data button on the Explorer page
- Uses cached AWS sessions (valid for 55 minutes)
- No need to re-enter MFA codes during the session cache window
- Imports data from the same profiles used in the last import
Tips
- Parallel Imports: Import multiple profiles simultaneously to save time
- Session Cache: Refresh multiple times within 55 minutes without re-entering MFA
- Regex Power: Use regex patterns for complex searches across your infrastructure
- CSV Exports: Export at any level (search results, individual resources, or rules)
- Quick Navigation: Use browser back/forward buttons or the built-in navigation links