Developers often overspend on cloud; this tool: Fetches Azure VM, app service, DB cost Predicts monthly bill Shows per-service breakdown Alerts if budget exceeds a limit Suggests cost-optimization tips
- To analyze Azure cloud resource costs
- To provide detailed cost breakdown and visualization
- To implement budget monitoring and alerting
- To integrate AI-based cost intelligence
Azure Cost Analyzer/
├── README.md
├── backend/ # FastAPI backend application
│ ├── alembic.ini
│ ├── docker-compose.yml
│ ├── Dockerfile
│ ├── entrypoint.sh
│ ├── pyproject.toml
│ ├── requirements.txt
│ └── app/
│ ├── config.py # Application configuration
│ ├── main.py # FastAPI application entry point
│ ├── scheduler.py # Task scheduler for alerts & anomalies
│ ├── alembic/ # Database migration scripts
│ │ ├── env.py
│ │ ├── README
│ │ ├── script.py.mako
│ │ └── versions/ # Migration history
│ ├── azure/ # Azure SDK integration
│ │ ├── auth.py # Azure authentication logic
│ │ └── cost_client.py # Azure Cost Management API client
│ ├── db/
│ │ ├── database.py # PostgreSQL connection setup
│ │ ├── models.py # SQLAlchemy ORM models
│ │ ├── operations.py # Generic database operations
│ │ └── alert_operations.py # Alert-specific DB operations
│ ├── exceptions/
│ │ └── cost_exceptions.py # Custom exception classes
│ ├── handlers/
│ │ └── exception_handlers.py # Global exception handlers
│ ├── models/ # Pydantic data models
│ │ ├── alert_models.py # Alert request/response models
│ │ └── cost_models.py # Cost analysis data models
│ ├── routes/ # API endpoints
│ │ ├── alert_routes.py # Alert API routes
│ │ └── cost_routes.py # Cost analysis API routes
│ ├── services/ # Business logic & orchestration
│ │ ├── alert_service.py # Alert management logic
│ │ ├── cache_service.py # Caching layer for performance
│ │ ├── cost_preprocessor.py # Data preprocessing pipeline
│ │ ├── cost_service.py # Cost data fetching & analysis
│ │ ├── cost_tasks.py # Background task definitions
│ │ └── email_service.py # Email notification service
│ └── utils/
│ └── responses.py # Standardized API response helpers
└── frontend/ # React + TypeScript UI application
├── package.json
├── tsconfig.json
├── vite.config.ts
├── tailwind.config.ts
├── postcss.config.js
├── eslint.config.js
├── vitest.config.ts
├── components.json
├── index.html
├── public/
│ ├── robots.txt
│ └── staticwebapp.config.json
└── src/
├── App.tsx
├── main.tsx
├── vite-env.d.ts
├── App.css
├── index.css
├── components/ # Reusable UI components
│ ├── AppSidebar.tsx
│ ├── NavLink.tsx
│ ├── dashboard/ # Dashboard-specific components
│ └── ui/ # Shadcn/ui components
├── hooks/ # Custom React hooks
│ ├── use-cost-data.ts
│ ├── use-mobile.tsx
│ └── use-toast.ts
├── lib/ # Utility functions & types
│ ├── api.ts # API client configuration
│ ├── colors.ts # Color constants
│ ├── config.ts # Frontend configuration
│ ├── types.ts # TypeScript type definitions
│ └── utils.ts # Helper utilities
├── pages/ # Page components
│ ├── Index.tsx # Dashboard home page
│ ├── CostAnalysis.tsx # Cost analysis page
│ ├── Budget.tsx # Budget management page
│ ├── Reports.tsx # Reports page
│ ├── Settings.tsx # Settings page
│ └── NotFound.tsx # 404 page
└── test/ # Test files
├── example.test.ts
└── setup.ts
- Python 3.11+ recommended
- Git installed
- (Optional) Azure CLI for auth workflows
# Install uv if needed
curl -LsSf https://astral.sh/uv/install.sh | sh
# Create and sync environment
uv venv
uv pip install -r requirements.txt
uv run app/main.pypython -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install --upgrade pip
pip install -r requirements.txt
python -m app/main.pyTo use this project, you must have:
- An Azure Subscription
- Billing Reader or Cost Management Reader role on that subscription
- Owner access (only once, to set things up)
-
Navigate to "Microsoft Entra ID (Azure AD)" → "App registrations" → "New registration".
-
Enter a name (eg: cost-analyzer)
-
Supported account types: Choose
Accounts in this organizational directory only (Single tenant) -
Click Register.
After registration, you land on Overview page.
Copy and save these safely:
| Field | What it is |
|---|---|
| Application (client) ID | App’s username |
| Directory (tenant) ID | Your Azure organization |
| Object ID | Internal Azure reference |
You will use:
Put them in a .env file later.
- Go to "Certificates & secrets" → "New client secret".
- Add a description and expiry, then click "Add".
- Copy the generated Value (this is your
AZURE_CLIENT_SECRET).
- In the Azure Portal, search for "Subscriptions".
- Select your subscription and copy the Subscription ID.
- Go to Subscriptions → "Access control (IAM)" → "Add role assignment".
- You'll see a long list of roles. Search for "Cost Management Reader" role → Click Next.
- Select your app (Service Principal):
i) search by app name or client id
ii) select it → click Select → click Next
- Review details:
i) Role: Cost Management Reader
ii) Scope: Subscription
iii) Member: Your app - Click Assign
Refer the .env.example from both backend and frontend folders. Create a .env file in each and fill in the required values.
The application supports sending email alerts for budget warnings and anomaly detection. Follow the steps below to configure SMTP:
-
Enable 2-Step Verification (if not already enabled):
- Go to myaccount.google.com/security
- Enable 2-Step Verification
-
Generate an App Password:
- Go to myaccount.google.com/apppasswords
- Select "Mail" and "Windows Computer" (or your device)
- Click "Generate"
- Copy the generated 16-character password
-
Add to .env:
SMTP_SERVER=smtp.gmail.com SMTP_PORT=587 SMTP_USERNAME=your-email@gmail.com SMTP_PASSWORD=your-16-char-app-password SMTP_FROM_EMAIL=your-email@gmail.com SMTP_FROM_NAME=Azure Cost Analyzer
-
You can also refer to How to Configure Gmail SMTP Server Settings