runbooks finops cost-drops

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

Usage: runbooks finops cost-drops [OPTIONS]

  Detect month-over-month cost drops across all linked accounts and services.

  Queries Cost Explorer (payer account) for monthly cost changes, then ranks
  by absolute dollar drop to surface likely decommissions.

  Compares FULL calendar months only — excludes incomplete current month to
  prevent false-positive drops (e.g., 4-day February vs 31-day January).

  Handles Cost Explorer pagination (5,000 group limit per page). Classifies
  signals: DECOMMISSION_LIKELY (>=80%), SIGNIFICANT_REDUCTION (>=50%),
  NOTABLE_REDUCTION (>=25%), MODERATE_REDUCTION (>=10%).

  Examples:     # Top 30 cost drops, 3-month lookback (default)     runbooks
  finops cost-drops --profile billing-readonly

      # Top 50, 6-month lookback, minimum $5 previous cost     runbooks finops
      cost-drops --profile billing --top 50 --months 6 --min-previous 5

      # Export all formats (JSON, CSV, XLSX)     runbooks finops cost-drops
      --profile billing --all-outputs --output-dir ./reports

      # With account name enrichment from Organizations     runbooks finops
      cost-drops --profile billing --org-profile management-readonly

Options:
  --profile TEXT                  AWS profile for single-account operations.

                                  📋 Profile Selection Guide: ━━━━━━━━━━━━━━━━━
                                  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

                                  Single Account → Use --profile YOUR_PROFILE
                                  Example: --profile dev-account   When:
                                  Developer/operator working in one AWS
                                  account

                                  Multi-Account LZ → Use --all-profiles (see
                                  inventory commands)   Example: --all-
                                  profiles   When: Platform team discovering
                                  across organization

                                  🔐 Enrichment Profiles (Automatic):   •
                                  Organizations: MANAGEMENT_PROFILE   • Costs:
                                  BILLING_PROFILE   Note: Separate from
                                  discovery profile

                                  Decision: Single account = --profile |
                                  Multi-account = --all-profiles
  --region TEXT                   AWS region override (default: ap-
                                  southeast-2)
  --dry-run                       Safe analysis mode - no resource
                                  modifications (enterprise default)
  -f, --format, --output-format [json|csv|table|pdf|markdown]
                                  Output format for results display
                                  (-f/--format preferred, --output-format
                                  legacy)
  --output-dir PATH               Directory for generated files and evidence
                                  packages
  --all-outputs                   Generate all output formats (JSON, CSV, PDF,
                                  Markdown) - use with --output-dir
  --csv                           Export to CSV format (convenience flag,
                                  activates --all-outputs)
  --json                          Export to JSON format (convenience flag,
                                  activates --all-outputs)
  --markdown                      Export to Markdown format (convenience flag,
                                  activates --all-outputs)
  --validate                      Enable MCP validation for enhanced accuracy
                                  (≥99.5% target)
  --confidence-threshold FLOAT    Minimum confidence threshold for validation
                                  (default: 99.5%%)
  --top INTEGER                   Number of top cost drops to display
                                  (default: 30)
  --months [2|3|4|6]              Number of full months to compare (default:
                                  3). Excludes incomplete current month.
  --min-previous FLOAT            Minimum previous month cost in USD to
                                  consider (default: 1.0)
  --org-profile TEXT              AWS management profile for Organizations
                                  account names (optional)
  --help                          Show this message and exit.

Examples