Skip to content

runbooks finops detect-rds-idleΒΆ

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

Usage: runbooks finops detect-rds-idle [OPTIONS]

  Detect idle RDS instances for $50K annual savings potential.

  Analyzes RDS instances using 5 idle signals: - I1: DatabaseConnections
  <10/day (40 points) - I2: CPUUtilization <5% avg (30 points) - I3: ReadIOPS
  + WriteIOPS <100/day (15 points) - I4: NetworkReceiveThroughput <1MB/day (10
  points) - I5: No recent snapshots modified (5 points)

  Recommendations: - Score 80-100: TERMINATE (high confidence idle) - Score
  60-79: STOP (medium confidence) - Score 40-59: DOWNSIZE (low utilization) -
  Score <40: KEEP (active usage)

  Examples:     # Basic idle detection with 7-day lookback     runbooks finops
  detect-rds-idle --profile prod

      # Extended analysis with 30-day lookback     runbooks finops detect-rds-
      idle --profile prod --lookback-days 30

      # Custom thresholds with JSON export     runbooks finops detect-rds-idle
      --profile prod --connection-threshold 5 --cpu-threshold 3.0 --export-
      json

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)
  --lookback-days INTEGER         Analysis period in days for CloudWatch
                                  metrics (default: 7)
  --connection-threshold INTEGER  Daily connection threshold for idle
                                  detection (default: 10)
  --cpu-threshold FLOAT           CPU percentage threshold for idle detection
                                  (default: 5.0)
  --export-json                   Export results to JSON file
  --output-file PATH              Output file path for JSON export
  --output-dir PATH               Output directory for exported files
  --help                          Show this message and exit.

ExamplesΒΆ