runbooks finops workspaces-decommission-analysis

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

Usage: runbooks finops workspaces-decommission-analysis [OPTIONS]

  WorkSpaces decommission analysis with W1-W6 scoring framework.

  This command provides enterprise WorkSpaces decommission candidate
  identification with: • W1-W6 multi-signal scoring (connection recency,
  CloudWatch usage, break-even, policy) • MUST/SHOULD/COULD/KEEP tier
  classification • Top 50 decommission candidates executive summary • Annual
  savings projections per WorkSpace • Professional Rich CLI output for CxO
  consumption

  Scoring Framework (0-100 scale): • MUST (80-100): Immediate decommission
  candidates • SHOULD (50-79): Strong candidates (review recommended) • COULD
  (25-49): Potential candidates (manual review) • KEEP (<25): Active resources
  (no action)

  Signal Framework (W1-W6): • W1: User connection recency (≥60 days) → +45
  points • W2: CloudWatch UserConnected sum=0 (no sessions) → +25 points • W3:
  Billing vs usage (hourly usage < break-even) → +10 points • W4: Cost
  Optimizer policy (N months unused) → +10 points • W5: No admin API activity
  (90d) → +5 points • W6: User status (not in Identity Center) → +5 points

  Examples:     # Basic decommission analysis     runbooks finops workspaces-
  decommission-analysis \         --input data/workspaces-inventory.xlsx \
  --output data/workspaces-decommission-analysis.xlsx \         --management-
  profile mgmt-ro \         --billing-profile billing-ro

      # With custom operational profile     runbooks finops workspaces-
      decommission-analysis \         -i data/workspaces.xlsx \         -o
      data/workspaces-decommission-full.xlsx \         -m mgmt-ro \         -b
      billing-ro \         -p ops-ro

  Input File Format:     Excel file with required columns:     - Identifier:
  WorkSpace ID (ws-xxxxx)     - AWS Account: 12-digit AWS account ID     -
  Region: AWS region (ap-southeast-2, etc.)

  Output File Format:     Multi-sheet Excel with:     - Sheet 1: Enriched Data
  (40+ columns with decommission scores)     - Sheet 2: Top 50 Decommission
  Candidates (executive summary)     - Sheet 3: Cost Summary (by account/tier)
  - Sheet 4: Validation Metrics

  Performance Notes:     • WorkSpaces enrichment: ~5-10 seconds     •
  CloudWatch metrics: ~10-15 seconds     • Volume encryption: ~5-10 seconds
  • Break-even calculation: <1 second

  Pattern: Migrated from notebooks/compute/workspaces.ipynb with CxO executive
  polish

Options:
  -i, --input PATH    Input WorkSpaces inventory Excel file (with Identifier,
                      AWS Account, Region columns)  [required]
  -o, --output PATH   Output enriched Excel file with decommission analysis
                      [required]
  --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