runbooks finops appstream-decommission-analysis

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

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

  AppStream decommission analysis with A1-A7 scoring framework.

  This command provides enterprise AppStream decommission candidate
  identification with: • A1-A7 multi-signal scoring (CloudTrail, sessions,
  Config, costs, utilization) • MUST/SHOULD/COULD/KEEP tier classification •
  Top 50 decommission candidates executive summary • Annual savings
  projections per fleet • 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 (A1-A7): • A1: CloudTrail activity (90d lookback) → +35
  points • A2: CloudWatch ActiveSessions (zero sessions) → +25 points • A3:
  AWS Config changes (90d) → +10 points • A4: Cost Explorer trends (flat/zero)
  → +10 points • A5: Session reports (DescribeSessions API) → +10 points • A6:
  Fleet utilization (capacity <5%) → +5 points • A7: User associations (zero
  users) → +5 points

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

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

      # Cost enrichment only (skip activity signals)     runbooks finops
      appstream-decommission-analysis \         -i data/appstream.csv \
      -o data/appstream-cost-only.xlsx \         -m mgmt-ro \         -b
      billing-ro \         --enrich cost

  Input File Format:     CSV file with required columns:     - resource_id:
  Fleet name     - account_id: 12-digit AWS account ID     - resource_arn:
  Fleet ARN

  Output File Format:     Multi-sheet Excel with:     - Sheet 1: AppStream
  Analysis (40+ columns with decommission scores)     - Sheet 2: Decommission
  Summary (by tier)     - Sheet 3: Signal Distribution

  Performance Notes:     • CloudTrail lookup: ~10-15 seconds per fleet     •
  CloudWatch metrics: ~5-10 seconds per fleet     • AWS Config history: ~5-10
  seconds per fleet     • Cost Explorer: <5 seconds total

  Pattern: Migrated from appstream_analyzer.py with CxO executive polish

Options:
  -i, --input PATH                Input AppStream inventory CSV file (default:
                                  /tmp/appstream_discovery.csv)
  -o, --output PATH               Output enriched Excel file with decommission
                                  analysis  [required]
  --enrich [organizations|cost|activity|all]
                                  Enrichment phases to execute (default: all)
  --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.
  --output-dir PATH               Output directory for exported files
  --help                          Show this message and exit.

Examples