← Back to Documentation

Report Format

After one run, StackSage generates an audit pack: a human-readable summary, a shareable HTML report, and machine-readable outputs.

Artifacts you get

  • summary.md — one-page, executive-friendly summary
  • audit_report.html — shareable report (evidence + remediation)
  • findings.json — full findings payload for automation
  • findings.csv — spreadsheet-friendly version
  • remediation_plan.md / remediation_plan.json — (paid) prioritized action plan

Finding fields (high-level)

Each finding includes a stable type, a resource_type, an id, and structured evidence. Many findings also include copyable verification_commands and remediation_commands.

{
  "type": "ec2_idle_instances",
  "resource_type": "ec2",
  "id": "i-0abc123...",
  "severity": "high",
  "confidence": 0.9,
  "estimated_monthly_savings_usd": 74.12,
  "evidence": { "cloudwatch": { "cpu_avg": 1.2 } },
  "verification_commands": ["aws ec2 describe-instances ..."],
  "remediation_commands": ["aws ec2 stop-instances ..."]
}

See a real example

You can browse a sample audit pack here: Sample Audit Pack.

Related topics