Skip to content

gaborl85/finops

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FinOps Toolkit

A comprehensive portfolio of scripts and tools for Financial Operations (FinOps) across cloud platforms. This toolkit helps organizations optimize cloud spending, detect cost anomalies, and maintain financial governance.

🎯 Project Vision

Build a modular collection of FinOps tools that enable:

  • Cost Visibility: Understand where money is being spent
  • Cost Optimization: Identify opportunities to reduce waste
  • Cost Governance: Enforce policies and budgets
  • Multi-Cloud Support: Work across Azure, AWS, GCP, and other providers

📦 Modules

Azure Cost Analysis

Location: azure/cost_analysis/

Tools for analyzing Azure costs with parameterized comparisons and anomaly detection.

Features:

  • Accumulated cost comparisons between any two time periods
  • Resource-level cost analysis with top increases
  • Automatic anomaly detection (new costs, removed costs, significant changes)
  • Clean, readable reports with ANSI-stripped output
  • Multi-subscription support with friendly naming

Scripts:

📖 Full Documentation

Future Modules (Planned)

  • AWS Cost Analysis - Similar tools for AWS Cost Explorer
  • GCP Cost Analysis - Google Cloud cost management tools
  • Budget Management - Cross-cloud budget tracking and alerting
  • Tagging Governance - Enforce and audit resource tagging
  • Reservation Optimization - Analyze and recommend reserved instances
  • Waste Detection - Identify unused or underutilized resources

🚀 Getting Started

Prerequisites

  • PowerShell 5.1 or higher (PowerShell Core 7+ recommended)
  • Cloud provider CLI tools (Azure CLI, AWS CLI, etc.)
  • Appropriate cloud permissions for cost management

Installation

  1. Clone this repository:
git clone <your-repo-url>
cd finops
  1. Navigate to the specific module you want to use:
cd azure/cost_analysis
  1. Follow the module-specific README for setup and usage instructions.

📁 Repository Structure

finops/
├── README.md                          # This file - main project overview
├── LICENSE                            # MIT License
├── .gitignore                         # Git ignore rules
└── azure/
    └── cost_analysis/
        ├── README.md                  # Module-specific documentation
        ├── requirements.txt           # Module dependencies
        ├── diff_accumulated/
        │   └── accumulatedCost.ps1   # Accumulated cost comparison
        └── diff_resource/
            └── diff_costByResource.ps1 # Resource-level analysis

🤝 Contributing

Contributions are welcome! Whether you want to:

  • Add support for new cloud providers
  • Create new FinOps tools
  • Improve existing scripts
  • Fix bugs or improve documentation

Development Guidelines

  1. Modularity: Keep tools organized by cloud provider and function
  2. Parameterization: Avoid hardcoded values; use parameters
  3. Documentation: Include clear README files and inline comments
  4. Error Handling: Implement robust error handling and validation
  5. Consistency: Follow PowerShell best practices and naming conventions

Contribution Process

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/new-tool
  3. Make your changes with clear commit messages
  4. Add or update documentation
  5. Test thoroughly
  6. Submit a Pull Request

📄 License

MIT License - See LICENSE file for details.

👥 Authors

FinOps Community Contributors

🐛 Issues & Support

If you encounter issues or have suggestions:

  • File an issue on the GitHub repository
  • Include module name, error messages, and steps to reproduce
  • Check existing issues before creating new ones

📚 Resources

FinOps Foundation

Cloud Provider Documentation

Tools & CLIs

🔄 Version History

See CHANGELOG.md for detailed version history and migration guides.

Latest Release: v2.0.0 (2026-01-13)

  • Modular structure with separate cloud provider modules
  • Parameterized scripts for flexible date ranges
  • Anomaly detection capabilities
  • Comprehensive documentation

💡 Use Cases

  • Monthly Cost Reviews: Compare costs month-over-month
  • Anomaly Detection: Identify unexpected cost spikes
  • Budget Management: Track spending against budgets
  • Chargeback/Showback: Allocate costs to teams or projects
  • Optimization: Find opportunities to reduce waste
  • Governance: Ensure compliance with cost policies

Note: This is an active project. Check individual module READMEs for specific features and usage instructions.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors