# Iris Cost Optimization Module

Terraform module for Iris cost governance across four operational areas:

1. `SpotInstanceUsage`: cost-optimized EKS node group + interruption events.
2. `RightSizing`: utilization alarms + Compute Optimizer enrollment.
3. `ResourceScheduling`: recurring ASG scale-down/scale-up schedules.
4. `CostAlerting`: monthly budget, anomaly detection, and billing alarms.

## What It Creates

- Spot-backed managed node group for burst/flexible workloads.
- EventBridge rule to capture EC2 spot interruption and rebalance events.
- Under/over-utilization alarms for configured Auto Scaling groups.
- Recurring scaling schedules for off-hours and business-hours capacity.
- Budget threshold notifications, anomaly subscription, and estimated-charge
  alarm.
- SSM profiles for right-sizing and schedule policy observability.

## Example Usage

```hcl
module "iris_cost" {
  source = "./infra/terraform/iris/cost"

  project_name = "iris"
  environment  = "prod"
  aws_region   = "us-east-1"

  cluster_name       = "iris-prod"
  node_role_arn      = "arn:aws:iam::123456789012:role/iris-prod-node-role"
  private_subnet_ids = ["subnet-aaa", "subnet-bbb", "subnet-ccc"]

  rightsizing_asg_names    = ["iris-prod-general", "iris-prod-workers"]
  scheduled_scaling_groups = ["iris-prod-general", "iris-prod-workers"]

  monthly_budget_amount_usd    = 20000
  budget_actual_threshold_pct  = 90
  budget_forecast_threshold_pct = 80
  cost_anomaly_threshold_usd   = 150
  budget_notification_emails   = ["finops@example.com", "platform-oncall@example.com"]
}
```

## Operational Notes

- Use spot capacity only for interruption-tolerant workloads.
- Keep at least one on-demand baseline node group for critical services.
- Start with conservative off-hours schedules, then tighten as usage stabilizes.
- Right-sizing alarms are signals for review; validate with workload SLOs before
  changing capacity.
- AWS billing metrics are emitted in `us-east-1`; the estimated-charges alarm is
  gated to that region.

## Validation

```bash
terraform -chdir=infra/terraform/iris/cost init
terraform -chdir=infra/terraform/iris/cost validate
terraform -chdir=infra/terraform/iris/cost plan
```
