Skip to main content

Starting a Scan

From the Dashboard

  1. Navigate to your ZapStack dashboard
  2. Select the AWS account(s) you want to scan
  3. Click Run Analysis
  4. Monitor progress in real-time

Scheduled Scans

Configure automated scans to run on a schedule:
  1. Go to Settings > Schedules
  2. Click Create Schedule
  3. Select accounts and frequency
  4. Save the schedule

Scan Options

Region Selection

By default, ZapStack scans all enabled regions. To limit regions:
  1. Go to Settings > AWS Accounts
  2. Select the account
  3. Click Configure Regions
  4. Enable/disable specific regions

Check Selection

Enable or disable specific checks:
  1. Go to Settings > Checks
  2. Toggle individual checks on/off
  3. Changes apply to future scans

Understanding Results

Finding States

StateDescription
OpenNew finding, not yet addressed
AcknowledgedFinding reviewed, planned for action
ResolvedFinding addressed, will be verified on next scan
IgnoredFinding dismissed, won’t appear in future scans

Severity Levels

SeverityTypical Monthly Impact
High$100+ potential savings
Medium$25-100 potential savings
LowLess than $25 potential savings

Exporting Results

Export findings for reporting or integration:

CSV Export

  1. View scan results
  2. Click Export > CSV
  3. Download the file

API Access

Use the API to programmatically access findings:
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.zapstack.io/v1/findings
See API Reference for details.

Scan History

View previous scan results:
  1. Go to Scans in the sidebar
  2. Select a previous scan
  3. Compare findings over time

Troubleshooting

Scan Stuck

If a scan appears stuck:
  1. Check the IAM role permissions
  2. Verify network connectivity to AWS
  3. Contact support if the issue persists

Missing Resources

If expected resources don’t appear:
  1. Verify the region is enabled for scanning
  2. Check IAM permissions include the service
  3. Ensure resources have appropriate tags (if filtering by tags)

Partial Results

If only some checks complete:
  1. Review the scan log for errors
  2. Check for API throttling (common in large accounts)
  3. Consider scanning fewer regions simultaneously