Skip to main content

Finops Toolkit

@swampadmin/finops-toolkitv2026.02.28.0· 5d agoMODELS·WORKFLOWS·VAULTS·REPORTS
01README

Multi-cloud FinOps toolkit for cost visibility, trend analysis, and anomaly detection.

Reports

  • Cost by Service — breakdown by cloud provider and service
  • Cost Trend — week-over-week and month-over-month timeseries
  • Anomaly Detection — ML-based spike detection with configurable thresholds
02Release Notes

Initial release with AWS and GCP cost models, weekly review workflow, and three report types.

Coming soon: Azure cost model, budget alerts, and Slack notification integration.

03Models2
@swampadmin/finops-toolkit/aws-costsv1.0.0aws-costs.ts

Global Arguments

ArgumentTypeDescription
account_idsarrayCloud account identifiers to query
fn fetch(account_id: string, date_range?: string)
fetch operation
ArgumentTypeDescription
account_idstringCloud account identifier
date_range?stringDate range (e.g. 'last-30d')
fn aggregate(group_by: string)
aggregate operation
ArgumentTypeDescription
group_bystringGrouping dimension (service, region, tag)
fn compare(name: string)
compare operation
ArgumentTypeDescription
namestringResource name
@swampadmin/finops-toolkit/gcp-costsv1.0.0gcp-costs.ts

Global Arguments

ArgumentTypeDescription
account_idsarrayCloud account identifiers to query
fn fetch(account_id: string, date_range?: string)
fetch operation
ArgumentTypeDescription
account_idstringCloud account identifier
date_range?stringDate range (e.g. 'last-30d')
fn aggregate(group_by: string)
aggregate operation
ArgumentTypeDescription
group_bystringGrouping dimension (service, region, tag)
04Workflows1
Weekly Cost Reviewweekly-cost-review

Weekly Cost Review workflow

weekly-cost-review-jobExecute Weekly Cost Review
1.Fetch AWS@swampadmin/finops-toolkit/aws-costs.fetch— Fetch AWS step
2.Fetch GCP@swampadmin/finops-toolkit/gcp-costs.fetch— Fetch GCP step
3.Aggregate@swampadmin/finops-toolkit/aws-costs.aggregate— Aggregate step
05Vaults1
cloud-credentialsconfigurable
vault-providercloud-creds.ts

cloud-credentials secrets provider

Config Fields

FieldTypeDescription
providerstringCloud provider (aws, gcp, azure)
credential_path?stringPath to service account credentials file
06Reports3
cost-by-servicemodel
cost-by-service.ts

Itemized cost breakdown by cloud provider and service category with month-over-month comparison

costfinopsbreakdown
cost-trendworkflow
cost-trend.ts

Weekly and monthly cost trend timeseries with linear projection and budget threshold markers

costtrendtimeseries
anomaly-detectionmodel
anomaly-detection.ts

ML-based spend anomaly detection with configurable sensitivity thresholds and Slack alert integration

costanomalyalerts
07Stats
Downloads
0
Archive size
186.0 KB

Not yet scored.

A score will be generated the next time this extension is published. The owner can also trigger scoring manually.

08Platforms
09Labels