Skip to main content
← back to extensions

Aws Cost Audit

@webframp/aws-cost-auditv2026.09.04.1· 7d agoWORKFLOWSREPORTS
01README

AWS cost audit workflow — identifies infrastructure waste by combining Cost Explorer spend data, resource inventory, and networking inspection. Generates a report with savings recommendations.

Quick Start

swamp extension pull @webframp/aws-cost-audit

swamp model create @webframp/aws/cost-explorer aws-costs --global-arg region=us-east-1
swamp model create @webframp/aws/networking aws-networking --global-arg region=us-east-1
swamp model create @webframp/aws/inventory aws-inventory --global-arg region=us-east-1

swamp workflow run @webframp/cost-audit

Required IAM Permissions

  • ce:GetCostAndUsage
  • ec2:DescribeInstances, ec2:DescribeNatGateways, ec2:DescribeAddresses
  • rds:DescribeDBInstances
  • dynamodb:ListTables, dynamodb:DescribeTable
  • lambda:ListFunctions
  • s3:ListBuckets
  • elasticloadbalancing:DescribeLoadBalancers, elasticloadbalancing:DescribeTargetGroups, elasticloadbalancing:DescribeTargetHealth
  • cloudwatch:GetMetricStatistics
02Release Notes

2026.09.04.1

Changed: Bump @webframp/aws/cost-explorer 2026.08.28.1 → 2026.08.29.1

Changed: Bump @webframp/aws/networking 2026.08.28.1 → 2026.08.29.1

Changed: Bump @webframp/aws/inventory 2026.08.28.1 → 2026.08.29.1

2026.08.28.3

Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.

Upgrade note: License text only. No API, schema, or runtime behavior changed.

2026.08.28.2

Fixed: Re-pinned @webframp/aws/cost-explorer, @webframp/aws/networking, and @webframp/aws/inventory to 2026.08.28.1 — the versions published in the prior sweep. The 2026.08.28.1 release of this composite still pinned the pre-sweep 2026.08.26.x leaf versions (SDK 3.1114.0), so its dependency graph did not deliver the AWS SDK 3.1120.0 bump it was bumped alongside. No schema or behavioral changes.

2026.08.28.1

Changed: Bump @webframp/aws/cost-explorer 2026.08.20.1 → 2026.08.26.2

Changed: Bump @webframp/aws/networking 2026.08.20.1 → 2026.08.26.2

Changed: Bump @webframp/aws/inventory 2026.08.20.1 → 2026.08.26.3

2026.08.26.1

Changed: Normalized deno.json configuration for repo-wide consistency: added explicit compilerOptions.strict and migrated zod dependency to the import map (bare "zod" specifier instead of inline npm:zod@4.4.3). No behavioral changes — runtime resolution is identical.

03Workflows1
@webframp/cost-auditdd789d8f-82ff-42d4-9e26-c5201c36a929

AWS cost audit workflow — gathers spend data from Cost Explorer, resource inventory, and networking details, then enriches with CloudWatch metrics and identifies top cost drivers. Results feed into the cost-audit report for savings recommendations.

gather-cost-and-resourcesCollect cost data and resource inventory in parallel
1.get-cost-by-serviceaws-costs.get_cost_by_service— Get cost breakdown by AWS service
2.get-cost-by-usage-type-ec2aws-costs.get_cost_by_usage_type— Get EC2 cost breakdown by usage type
3.get-cost-by-usage-type-rdsaws-costs.get_cost_by_usage_type— Get RDS cost breakdown by usage type
4.get-cost-by-usage-type-s3aws-costs.get_cost_by_usage_type— Get S3 cost breakdown by usage type
5.get-cost-by-usage-type-lambdaaws-costs.get_cost_by_usage_type— Get Lambda cost breakdown by usage type
6.get-cost-trendaws-costs.get_cost_trend— Get daily cost trend over the period
7.get-cost-comparisonaws-costs.get_cost_comparison— Compare current period costs to previous period
8.inventory-allaws-inventory.inventory_all— Gather full resource inventory including stopped instances and EBS
9.list-nat-gatewaysaws-networking.list_nat_gateways— List NAT Gateways for networking waste analysis
10.list-load-balancersaws-networking.list_load_balancers— List load balancers for utilization analysis
11.list-elastic-ipsaws-networking.list_elastic_ips— List Elastic IPs to find unattached addresses
enrich-metricsGather data transfer metrics for networking resources
1.get-data-transfer-metricsaws-networking.get_data_transfer_metrics— Get data transfer metrics for NAT Gateways and load balancers
deep-divePerform deeper cost analysis based on initial findings
1.get-top-cost-driversaws-costs.get_top_cost_drivers— Identify the top cost drivers by service and usage type
04Reports1
@webframp/cost-audit-reportworkflow
cost_audit_report.ts

Aggregates cost, inventory, and networking data from the cost-audit workflow into a savings report

awscostfinopsaudit
05Previous Versions19
2026.08.28.3

2026.08.28.3

Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.

Upgrade note: License text only. No API, schema, or runtime behavior changed.

2026.08.28.2

Fixed: Re-pinned @webframp/aws/cost-explorer, @webframp/aws/networking, and @webframp/aws/inventory to 2026.08.28.1 — the versions published in the prior sweep. The 2026.08.28.1 release of this composite still pinned the pre-sweep 2026.08.26.x leaf versions (SDK 3.1114.0), so its dependency graph did not deliver the AWS SDK 3.1120.0 bump it was bumped alongside. No schema or behavioral changes.

2026.08.28.1

Changed: Bump @webframp/aws/cost-explorer 2026.08.20.1 → 2026.08.26.2

Changed: Bump @webframp/aws/networking 2026.08.20.1 → 2026.08.26.2

Changed: Bump @webframp/aws/inventory 2026.08.20.1 → 2026.08.26.3

2026.08.26.1

Changed: Normalized deno.json configuration for repo-wide consistency: added explicit compilerOptions.strict and migrated zod dependency to the import map (bare "zod" specifier instead of inline npm:zod@4.4.3). No behavioral changes — runtime resolution is identical.

2026.08.28.2

2026.08.28.2

Fixed: Re-pinned @webframp/aws/cost-explorer, @webframp/aws/networking, and @webframp/aws/inventory to 2026.08.28.1 — the versions published in the prior sweep. The 2026.08.28.1 release of this composite still pinned the pre-sweep 2026.08.26.x leaf versions (SDK 3.1114.0), so its dependency graph did not deliver the AWS SDK 3.1120.0 bump it was bumped alongside. No schema or behavioral changes.

2026.08.28.1

Changed: Bump @webframp/aws/cost-explorer 2026.08.20.1 → 2026.08.26.2

Changed: Bump @webframp/aws/networking 2026.08.20.1 → 2026.08.26.2

Changed: Bump @webframp/aws/inventory 2026.08.20.1 → 2026.08.26.3

2026.08.26.1

Changed: Normalized deno.json configuration for repo-wide consistency: added explicit compilerOptions.strict and migrated zod dependency to the import map (bare "zod" specifier instead of inline npm:zod@4.4.3). No behavioral changes — runtime resolution is identical.

updated dependencies

2026.08.28.1

2026.08.28.1

Changed: Bump @webframp/aws/cost-explorer 2026.08.20.1 → 2026.08.26.2

Changed: Bump @webframp/aws/networking 2026.08.20.1 → 2026.08.26.2

Changed: Bump @webframp/aws/inventory 2026.08.20.1 → 2026.08.26.3

2026.08.26.1

Changed: Normalized deno.json configuration for repo-wide consistency: added explicit compilerOptions.strict and migrated zod dependency to the import map (bare "zod" specifier instead of inline npm:zod@4.4.3). No behavioral changes — runtime resolution is identical.

updated dependencies

2026.08.26.1

2026.08.26.1

Changed: Normalized deno.json configuration for repo-wide consistency: added explicit compilerOptions.strict and migrated zod dependency to the import map (bare "zod" specifier instead of inline npm:zod@4.4.3). No behavioral changes — runtime resolution is identical.

2026.08.25.1

2026.08.25.1

Changed: Updated labels for improved extension discoverability. Added cross-cutting category labels (security, observability, finops, infrastructure, networking, compliance, devops, ai, incident-response) where applicable.

updated labels

2026.08.24.1

2026.08.24.1

Added: Troubleshooting section documenting the allowFailure: true all-steps behavior, the dead region workflow input, MAX_PAGES = 10 truncation in dependent models, and the regions (array) vs region (string) mismatch for the inventory model.

2026.08.21.1

2026.08.21.1

Changed: The report's getData helper no longer treats every read/parse failure as "no data available." A missing data artifact (the producing step didn't run) still returns null silently, but a file-permission error or malformed JSON now logs a message naming the artifact path and the underlying error, instead of swallowing it and silently rendering the report as if the data were absent.

2026.08.20.1

Changed: Bump @webframp/aws/cost-explorer 2026.08.13.1 → 2026.08.20.1

Changed: Bump @webframp/aws/networking 2026.08.05.1 → 2026.08.20.1

Changed: Bump @webframp/aws/inventory 2026.08.05.1 → 2026.08.20.1

2026.08.15.1

Changed: Bump @webframp/aws/cost-explorer 2026.08.02.1 → 2026.08.13.1

Changed: Bump @webframp/aws/networking 2026.08.02.1 → 2026.08.05.1

Changed: Bump @webframp/aws/inventory 2026.08.02.1 → 2026.08.05.1

2026.08.05.1

Changed: Bump @webframp/aws/cost-explorer 2026.08.01.1 → 2026.08.02.1

Changed: Bump @webframp/aws/networking 2026.08.01.1 → 2026.08.02.1

Changed: Bump @webframp/aws/inventory 2026.08.01.1 → 2026.08.02.1

2026.08.02.1

Changed: Bump @webframp/aws/cost-explorer 2026.07.30.1 → 2026.08.01.1

Changed: Bump @webframp/aws/networking 2026.07.30.1 → 2026.08.01.1

Changed: Bump @webframp/aws/inventory 2026.07.30.1 → 2026.08.01.1

2026.07.31.1

Changed: Bump @webframp/aws/cost-explorer 2026.07.24.1 → 2026.07.30.1

Changed: Bump @webframp/aws/networking 2026.07.24.1 → 2026.07.30.1

Changed: Bump @webframp/aws/inventory 2026.07.24.1 → 2026.07.30.1

2026.07.27.1

Changed: Bump @webframp/aws/cost-explorer 2026.07.21.1 → 2026.07.24.1

Changed: Bump @webframp/aws/networking 2026.07.21.1 → 2026.07.24.1

Changed: Bump @webframp/aws/inventory 2026.07.21.1 → 2026.07.24.1

2026.07.24.1

Changed: Bump dependency pins to latest published versions:

  • @webframp/aws/cost-explorer 2026.07.18.1 → 2026.07.21.1
  • @webframp/aws/networking 2026.07.18.1 → 2026.07.21.1
  • @webframp/aws/inventory 2026.07.18.1 → 2026.07.21.1
2026.08.20.1

2026.08.20.1

Changed: Bump @webframp/aws/cost-explorer 2026.08.13.1 → 2026.08.20.1

Changed: Bump @webframp/aws/networking 2026.08.05.1 → 2026.08.20.1

Changed: Bump @webframp/aws/inventory 2026.08.05.1 → 2026.08.20.1

2026.08.15.1

Changed: Bump @webframp/aws/cost-explorer 2026.08.02.1 → 2026.08.13.1

Changed: Bump @webframp/aws/networking 2026.08.02.1 → 2026.08.05.1

Changed: Bump @webframp/aws/inventory 2026.08.02.1 → 2026.08.05.1

2026.08.05.1

Changed: Bump @webframp/aws/cost-explorer 2026.08.01.1 → 2026.08.02.1

Changed: Bump @webframp/aws/networking 2026.08.01.1 → 2026.08.02.1

Changed: Bump @webframp/aws/inventory 2026.08.01.1 → 2026.08.02.1

2026.08.02.1

Changed: Bump @webframp/aws/cost-explorer 2026.07.30.1 → 2026.08.01.1

Changed: Bump @webframp/aws/networking 2026.07.30.1 → 2026.08.01.1

Changed: Bump @webframp/aws/inventory 2026.07.30.1 → 2026.08.01.1

2026.07.31.1

Changed: Bump @webframp/aws/cost-explorer 2026.07.24.1 → 2026.07.30.1

Changed: Bump @webframp/aws/networking 2026.07.24.1 → 2026.07.30.1

Changed: Bump @webframp/aws/inventory 2026.07.24.1 → 2026.07.30.1

2026.07.27.1

Changed: Bump @webframp/aws/cost-explorer 2026.07.21.1 → 2026.07.24.1

Changed: Bump @webframp/aws/networking 2026.07.21.1 → 2026.07.24.1

Changed: Bump @webframp/aws/inventory 2026.07.21.1 → 2026.07.24.1

2026.07.24.1

Changed: Bump dependency pins to latest published versions:

  • @webframp/aws/cost-explorer 2026.07.18.1 → 2026.07.21.1
  • @webframp/aws/networking 2026.07.18.1 → 2026.07.21.1
  • @webframp/aws/inventory 2026.07.18.1 → 2026.07.21.1

updated dependencies

2026.08.15.1

2026.08.15.1

Changed: Bump @webframp/aws/cost-explorer 2026.08.02.1 → 2026.08.13.1

Changed: Bump @webframp/aws/networking 2026.08.02.1 → 2026.08.05.1

Changed: Bump @webframp/aws/inventory 2026.08.02.1 → 2026.08.05.1

2026.08.05.1

Changed: Bump @webframp/aws/cost-explorer 2026.08.01.1 → 2026.08.02.1

Changed: Bump @webframp/aws/networking 2026.08.01.1 → 2026.08.02.1

Changed: Bump @webframp/aws/inventory 2026.08.01.1 → 2026.08.02.1

2026.08.02.1

Changed: Bump @webframp/aws/cost-explorer 2026.07.30.1 → 2026.08.01.1

Changed: Bump @webframp/aws/networking 2026.07.30.1 → 2026.08.01.1

Changed: Bump @webframp/aws/inventory 2026.07.30.1 → 2026.08.01.1

2026.07.31.1

Changed: Bump @webframp/aws/cost-explorer 2026.07.24.1 → 2026.07.30.1

Changed: Bump @webframp/aws/networking 2026.07.24.1 → 2026.07.30.1

Changed: Bump @webframp/aws/inventory 2026.07.24.1 → 2026.07.30.1

2026.07.27.1

Changed: Bump @webframp/aws/cost-explorer 2026.07.21.1 → 2026.07.24.1

Changed: Bump @webframp/aws/networking 2026.07.21.1 → 2026.07.24.1

Changed: Bump @webframp/aws/inventory 2026.07.21.1 → 2026.07.24.1

2026.07.24.1

Changed: Bump dependency pins to latest published versions:

  • @webframp/aws/cost-explorer 2026.07.18.1 → 2026.07.21.1
  • @webframp/aws/networking 2026.07.18.1 → 2026.07.21.1
  • @webframp/aws/inventory 2026.07.18.1 → 2026.07.21.1

updated dependencies

2026.08.05.1

2026.08.05.1

Changed: Bump @webframp/aws/cost-explorer 2026.08.01.1 → 2026.08.02.1

Changed: Bump @webframp/aws/networking 2026.08.01.1 → 2026.08.02.1

Changed: Bump @webframp/aws/inventory 2026.08.01.1 → 2026.08.02.1

2026.08.02.1

Changed: Bump @webframp/aws/cost-explorer 2026.07.30.1 → 2026.08.01.1

Changed: Bump @webframp/aws/networking 2026.07.30.1 → 2026.08.01.1

Changed: Bump @webframp/aws/inventory 2026.07.30.1 → 2026.08.01.1

2026.07.31.1

Changed: Bump @webframp/aws/cost-explorer 2026.07.24.1 → 2026.07.30.1

Changed: Bump @webframp/aws/networking 2026.07.24.1 → 2026.07.30.1

Changed: Bump @webframp/aws/inventory 2026.07.24.1 → 2026.07.30.1

2026.07.27.1

Changed: Bump @webframp/aws/cost-explorer 2026.07.21.1 → 2026.07.24.1

Changed: Bump @webframp/aws/networking 2026.07.21.1 → 2026.07.24.1

Changed: Bump @webframp/aws/inventory 2026.07.21.1 → 2026.07.24.1

2026.07.24.1

Changed: Bump dependency pins to latest published versions:

  • @webframp/aws/cost-explorer 2026.07.18.1 → 2026.07.21.1
  • @webframp/aws/networking 2026.07.18.1 → 2026.07.21.1
  • @webframp/aws/inventory 2026.07.18.1 → 2026.07.21.1

updated dependencies

2026.08.02.1

2026.08.02.1

Changed: Bump @webframp/aws/cost-explorer 2026.07.30.1 → 2026.08.01.1

Changed: Bump @webframp/aws/networking 2026.07.30.1 → 2026.08.01.1

Changed: Bump @webframp/aws/inventory 2026.07.30.1 → 2026.08.01.1

2026.07.31.1

Changed: Bump @webframp/aws/cost-explorer 2026.07.24.1 → 2026.07.30.1

Changed: Bump @webframp/aws/networking 2026.07.24.1 → 2026.07.30.1

Changed: Bump @webframp/aws/inventory 2026.07.24.1 → 2026.07.30.1

2026.07.27.1

Changed: Bump @webframp/aws/cost-explorer 2026.07.21.1 → 2026.07.24.1

Changed: Bump @webframp/aws/networking 2026.07.21.1 → 2026.07.24.1

Changed: Bump @webframp/aws/inventory 2026.07.21.1 → 2026.07.24.1

2026.07.24.1

Changed: Bump dependency pins to latest published versions:

  • @webframp/aws/cost-explorer 2026.07.18.1 → 2026.07.21.1
  • @webframp/aws/networking 2026.07.18.1 → 2026.07.21.1
  • @webframp/aws/inventory 2026.07.18.1 → 2026.07.21.1

updated dependencies

2026.07.31.1

2026.07.31.1

Changed: Bump @webframp/aws/cost-explorer 2026.07.24.1 → 2026.07.30.1

Changed: Bump @webframp/aws/networking 2026.07.24.1 → 2026.07.30.1

Changed: Bump @webframp/aws/inventory 2026.07.24.1 → 2026.07.30.1

2026.07.27.1

Changed: Bump @webframp/aws/cost-explorer 2026.07.21.1 → 2026.07.24.1

Changed: Bump @webframp/aws/networking 2026.07.21.1 → 2026.07.24.1

Changed: Bump @webframp/aws/inventory 2026.07.21.1 → 2026.07.24.1

2026.07.24.1

Changed: Bump dependency pins to latest published versions:

  • @webframp/aws/cost-explorer 2026.07.18.1 → 2026.07.21.1
  • @webframp/aws/networking 2026.07.18.1 → 2026.07.21.1
  • @webframp/aws/inventory 2026.07.18.1 → 2026.07.21.1

updated dependencies

2026.07.27.1

2026.07.27.1

Changed: Bump @webframp/aws/cost-explorer 2026.07.21.1 → 2026.07.24.1

Changed: Bump @webframp/aws/networking 2026.07.21.1 → 2026.07.24.1

Changed: Bump @webframp/aws/inventory 2026.07.21.1 → 2026.07.24.1

2026.07.24.1

Changed: Bump dependency pins to latest published versions:

  • @webframp/aws/cost-explorer 2026.07.18.1 → 2026.07.21.1
  • @webframp/aws/networking 2026.07.18.1 → 2026.07.21.1
  • @webframp/aws/inventory 2026.07.18.1 → 2026.07.21.1

updated dependencies

2026.07.24.1

2026.07.24.1

Changed: Bump dependency pins to latest published versions:

  • @webframp/aws/cost-explorer 2026.07.18.1 → 2026.07.21.1
  • @webframp/aws/networking 2026.07.18.1 → 2026.07.21.1
  • @webframp/aws/inventory 2026.07.18.1 → 2026.07.21.1

updated dependencies

2026.07.20.1

2026.07.20.1

Changed: Refreshed dependency pins to the latest published releases. No behavioral changes to the cost-audit workflow or report.

Upgrade note: Bumps @webframp/aws/cost-explorer, @webframp/aws/networking, and @webframp/aws/inventory 2026.05.20.1 → 2026.07.18.1, pulled automatically with this extension.

updated dependencies

2026.07.18.1

2026.07.18.1

Changed: Version bump only, no code changes.

2026.07.16.1

Changed: README and LICENSE reformatted (deno fmt) in PR #134; this is the first version bump to publish that formatting to the registry. No functional or behavioral change.

2026.07.16.1

2026.07.16.1

Changed: README and LICENSE reformatted (deno fmt) in PR #134; this is the first version bump to publish that formatting to the registry. No functional or behavioral change.

2026.05.24.1

updated dependencies

2026.04.22.1

updated platforms

06Stats
A
100 / 100
Downloads
28
Archive size
17.5 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
Repository
https://github.com/webframp/swamp-extensions
07Platforms
08Labels
#audit#aws#compliance#cost#finops#infrastructure#networking#workflow