Computeoptimizer Diagnostics

AWS Compute Optimizer Diagnostics

When to use

Any AWS Compute Optimizer investigation — EC2/Lambda/EBS/ECS recommendations, enrollment, or export.

Investigation workflow

Step 1 — Collect and triage

aws compute-optimizer get-enrollment-status
aws compute-optimizer get-enrollment-statuses-for-organization
aws compute-optimizer get-recommendation-summaries

Step 2 — Domain deep dive

aws compute-optimizer get-ec2-instance-recommendations --instance-arns 
aws compute-optimizer get-lambda-function-recommendations --function-arns 
aws compute-optimizer get-ebs-volume-recommendations --volume-arns 
aws compute-optimizer get-ecs-service-recommendations --service-arns 

Step 3 — Detailed investigation

aws compute-optimizer get-ec2-recommendation-projected-metrics --instance-arn  --stat Maximum --period 86400 --start-time  --end-time 
aws compute-optimizer describe-recommendation-export-jobs

Read references/guardrails.md before concluding on any Compute Optimizer issue.

Gotchas: AWS Compute Optimizer

• Account must be enrolled (opted in) before recommendations appear.
• Recommendations require 14+ days of CloudWatch metric data.
• Enhanced infrastructure metrics (paid) provide 3-month lookback.
• Export jobs write to S3 and are asynchronous.
• Organization enrollment requires management account action.
• Recommendations are resource-type specific with different criteria.

Anti-hallucination rules

1. Always cite resource ARNs, recommendation details, or API responses as evidence.
2. Enrollment is required. Never assume recommendations exist without opt-in.
3. 14 days of data minimum. Never expect instant recommendations.
4. Spend no more than 2 minutes on any single hypothesis. Pivot if inconclusive.

12 runbooks

| Category | IDs | Covers | |----------|-----|--------| | A — EC2 | A1-A2 | Instance recommendations, projected metrics | | B — Lambda | B1-B2 | Function recommendations, memory sizing | | C — EBS | C1-C2 | Volume recommendations, IOPS optimization | | D — ECS | D1-D2 | Service recommendations, task sizing | | E — Enrollment | E1-E2 | Account enrollment, organization enrollment | | F — Export | F1-F2 | Export jobs, export configuration |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: aws-samples
• Source: aws-samples/sample-ai-agent-skills
• License: MIT-0

Install and usage instructions live in the source repository linked above.