Skip to content

runbooks inventory enrichΒΆ

Auto-generated from runbooks inventory enrich --help on 2026-05-21. Source of truth: runbooks PyPI package v1.3.22

Usage: runbooks inventory enrich [OPTIONS] INPUT_FILE

  Unified enrichment command with 5-layer pipeline orchestration.

  Executes enrichment layers with optimized parallel execution: - Phase 1
  (Parallel): Organizations + Costs (independent layers) - Phase 2
  (Sequential): Activity (depends on Organizations metadata) - Phase 3
  (Sequential): Scoring (depends on Costs + Activity)

  Layers:   organizations: Add AWS Organizations account metadata (Layer 2)
  costs: Add Cost Explorer financial data (Layer 3)   activity: Add
  CloudTrail/CloudWatch activity signals (Layer 4)   scoring: Calculate
  decommission scores (Layer 5)   all: Execute all layers in dependency order

  Examples:     # Full 5-layer pipeline (parallel optimization: 60s β†’ 45s)
  runbooks inventory enrich discovered.csv --layers all \       --management-
  profile mgmt --billing-profile billing \       --operational-profile ops
  --output-dir ./outputs

      # Organizations + Costs only (parallel execution)     runbooks inventory
      enrich discovered.csv \       --layers organizations,costs --output-dir
      ./outputs

      # Activity enrichment for EC2 instances     runbooks inventory enrich
      enriched-costs.csv \       --layers activity --resource-type ec2 \
      --activity-lookback-days 90

Options:
  --layers TEXT                   Comma-separated layers:
                                  organizations,costs,activity,scoring
                                  (default: all)
  --operational-profile TEXT      AWS profile for CloudTrail/CloudWatch (Layer
                                  4)
  --output-dir PATH               Output directory for enriched files
  --resource-type [ec2|workspaces|snapshots|lambda|rds]
                                  Resource type for activity enrichment (Layer
                                  4)
  --months INTEGER                Number of trailing months for cost analysis
                                  (Layer 3)
  --activity-lookback-days INTEGER
                                  Days to look back for activity signals
                                  (Layer 4)
  --score-threshold FLOAT         Minimum decommission score threshold (Layer
                                  5)
  -v, --verbose                   Show detailed execution logs
  --dry-run                       Validate inputs without execution
  --help                          Show this message and exit.

ExamplesΒΆ