Skip to content

runbooks inventory enrich-ec2ΒΆ

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

Usage: runbooks inventory enrich-ec2 [OPTIONS]

  Enrich EC2 inventory with Organizations metadata, Cost Explorer data, and
  CloudTrail activity.

  Extends existing EC2 inventory files with business context from AWS
  Organizations, cost tracking from Cost Explorer API, and activity analysis
  via CloudTrail.

  Required Input Columns:     - account_id: AWS account ID (12-digit string)
  - instance_id: EC2 instance ID (i-xxxxxxxxx format)

  Added Enrichment Columns:     Organizations: account_name, account_email,
  wbs_code, cost_group, technical_lead, account_owner     Cost: monthly_cost,
  annual_cost_12mo     Activity: last_activity_date, days_since_activity,
  activity_count_90d, is_idle     SSM: ssm_agent_status, ssm_ping_status (SSM
  Agent reachability via Systems Manager)

  Examples:     # Basic enrichment with all features     runbooks inventory
  enrich-ec2 -i data/ec2.xlsx -o data/enriched.xlsx -p mgmt-profile

      # Organizations metadata only     runbooks inventory enrich-ec2 -i
      data/ec2.csv -o data/enriched.csv --no-cost --no-activity

      # Display without export     runbooks inventory enrich-ec2 -i
      data/ec2.xlsx --display-only -p my-profile

      # Separate billing profile for Cost Explorer     runbooks inventory
      enrich-ec2 -i data/ec2.xlsx -o data/enriched.xlsx -p mgmt -b billing

Options:
  -i, --input PATH               Input EC2 data file (Excel/CSV with
                                 account_id and instance_id columns)
                                 [required]
  -o, --output PATH              Output enriched data file (Excel/CSV/JSON)
  -p, --profile TEXT             AWS management profile (Organizations +
                                 CloudTrail access, defaults to group-level
                                 --profile)
  -f, --format [csv|excel|json]  Output format (default: csv)
  --display-only                 Display Rich CLI output without file export
  --no-organizations             Skip Organizations enrichment
  --no-cost                      Skip Cost Explorer enrichment
  --no-activity                  Skip CloudTrail activity enrichment
  --help                         Show this message and exit.

ExamplesΒΆ