runbooks finops optimize-savings-plans

Auto-generated from runbooks finops optimize-savings-plans --help on 2026-05-21. Source of truth: runbooks PyPI package v1.3.22

Usage: runbooks finops optimize-savings-plans [OPTIONS]

  Generate hybrid Savings Plans + RI recommendations (60/30/10 strategy).

  🎯 HYBRID OPTIMIZATION STRATEGY
  • 60% Compute SP (flexible across EC2/Fargate/Lambda, 66% savings)
  • 30% EC2 Instance SP (stable workloads, 72% savings)
  • 10% On-Demand (burst capacity, flexibility)

  📊 WORKLOAD CLASSIFICATION
  Stable workloads (EC2 Instance SP candidates):
  • Coefficient of Variation (CV) < 0.15
  • Uptime > 95% over analysis period
  • ≤2 regions (single or limited multi-region)

  Variable workloads (Compute SP candidates): • CV ≥ 0.15 (fluctuating usage
  patterns) • Multi-region (3+ regions for flexibility)

  💰 FINANCIAL MODELING
  • Break-even analysis (target: <10 months)
  • ROI calculations with upfront cost amortization
  • Annual savings projections ($500K+ target)
  • MCP validation (≥99.5% accuracy for major commitments)

  🔧 ANALYSIS PERIOD
  • Default: 90 days (3 months minimum for SP sizing)
  • Minimum: 30 days (shorter periods reduce accuracy)
  • Recommended: 90-180 days for seasonal patterns

  📖 Examples:
      # Basic SP optimization with 90-day analysis
      runbooks finops optimize-savings-plans \
          --billing-profile billing-account

      # 6-month analysis for seasonal patterns     runbooks finops optimize-
      savings-plans \         --lookback-days 180 \         --billing-profile
      billing-account

      # 3-year term with partial upfront     runbooks finops optimize-savings-
      plans \         --term-years 3 \         --payment-option
      PARTIAL_UPFRONT \         --billing-profile billing-account

      # Export to Excel with verbose logging     runbooks finops optimize-
      savings-plans \         --billing-profile billing-account \
      --output sp-recommendations.xlsx \         --verbose

      # Disable MCP validation (faster, but no accuracy guarantee)
      runbooks finops optimize-savings-plans \         --billing-profile
      billing-account \         --no-mcp-validation

  🎯 Epic 5 Feature 3: Savings Plans Hybrid Optimizer
  Timeline: 5 days (4 dev + 1 testing)
  Business Impact: $500K+ annual savings potential
  Target Accuracy: ≥99.5% MCP validation for cost projections

  Pattern: Follows reservation_optimizer.py proven patterns with Rich CLI standards
  Integration: Complementary to existing RI optimizer for unified procurement strategy

Options:
  --lookback-days INTEGER         Usage history analysis period (default: 90
                                  days, minimum: 30)
  --term-years [1|3]              Commitment term: 1-year or 3-year (default:
                                  1)
  --payment-option [ALL_UPFRONT|PARTIAL_UPFRONT|NO_UPFRONT]
                                  Payment option (default: NO_UPFRONT)
  --profile TEXT                  AWS profile (convenience — maps to billing
                                  profile)
  --validate-with-mcp / --no-mcp-validation
                                  Enable MCP validation (≥99.5% accuracy,
                                  default: enabled)
  --output PATH                   Export recommendations to Excel
  --verbose                       Enable verbose logging
  --help                          Show this message and exit.

Examples