runbooks finops analyze-workspaces

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

Usage: runbooks finops analyze-workspaces [OPTIONS]

  WorkSpaces cost analysis with decommission tier scoring.

  🔄 4-WAY ENRICHMENT LAYERS (W1-W6 Decommission Scoring)
  ┌──────────────────────────────────────────────────────────────┐
  │ Layer 1: Discovery       │ WorkSpaces inventory (122 total)  │
  │ Layer 2: Organizations   │ Account metadata (6 columns)      │
  │ Layer 3: Cost            │ 12-month Cost Explorer trends     │
  │ Layer 4: Activity        │ CloudWatch UserConnected metrics  │
  └──────────────────────────────────────────────────────────────┘

  📊 DECOMMISSION SIGNALS (W1-W6)
  • W1: WorkSpace stopped state → +15 points (HIGH priority)
  • W2: Zero UserConnected time (30d) → +12 points (Idle workspace)
  • W3: Low monthly cost (<$10) → +8 points (Basic bundle)
  • W4: Cost decreasing trend → +5 points (Usage declining)
  • W5: No volume encryption → +3 points (Compliance risk)
  • W6: Legacy bundle type → +2 points (Modernization opportunity)

  🎯 OPTIMIZATION TIERS
  • HIGH (≥25 points): Immediate decommission candidates
  • MEDIUM (15-24 points): Review recommended within 30 days
  • LOW (<15 points): Monitor and maintain current state

  💰 Sprint 1 Target: 25-50% cost savings via tier-based decommission
  📖 Example: runbooks finops analyze-workspaces -i ws.xlsx -o enriched.xlsx -m mgmt -b billing

Options:
  -i, --input PATH                Input WorkSpaces inventory Excel file (with
                                  Identifier, AWS Account, Region columns)
                                  [required]
  -o, --output PATH               Output enriched Excel file (multi-sheet with
                                  cost analysis)  [required]
  --enable-organizations / --no-organizations
                                  Enable Organizations metadata enrichment
                                  (default: enabled)
  --enable-cost / --no-cost       Enable Cost Explorer enrichment (default:
                                  enabled)
  --enable-activity / --no-activity
                                  Enable CloudTrail activity tracking
                                  (default: disabled, takes 60-90 seconds)
  --include-12month-cost / --no-12month-cost
                                  Include 12-month cost breakdown (default:
                                  enabled)
  -v, --verbose                   Show detailed logs
  --format [compact|table|json]   Output format
  --output-dir PATH               Output directory for exported files
  --profile TEXT                  AWS profile (KISS: auto-resolves
                                  management/billing/ops from
                                  AWS_MANAGEMENT_PROFILE, AWS_BILLING_PROFILE
                                  env vars)
  --all-profile TEXT              Multi-Account: management profile for
                                  Organizations + Cost Explorer across all
                                  accounts. Resolves MANAGEMENT, BILLING,
                                  OPERATIONAL profiles from env vars.
  --help                          Show this message and exit.

Examples