AWS cost-management documentation change
Summary
Comprehensive rewrite of Amazon Q Developer cost management documentation, expanding capabilities description, adding use cases, example questions, implementation guidance, and multi-account management details
Security assessment
The changes focus on enhancing feature documentation and user guidance without addressing specific security vulnerabilities. Security-related content added includes IAM permission requirements and a link to security documentation, which is routine security best practice guidance rather than addressing a vulnerability.
Diff
diff --git a/cost-management/latest/userguide/ce-q-overview.md b/cost-management/latest/userguide/ce-q-overview.md index a00c17dfb..2f9a6e4ba 100644 --- a//cost-management/latest/userguide/ce-q-overview.md +++ b//cost-management/latest/userguide/ce-q-overview.md @@ -5 +5 @@ -Cost analysisCost optimizationPricing and cost estimationGetting startedPricing +What you can doHow to use itUser experienceMulti-account cost managementGetting startedNext stepsPricing @@ -9 +9 @@ Cost analysisCost optimizationPricing and cost estimationGetting startedPricing -Amazon Q Developer provides powerful capabilities to help you understand and optimize your AWS costs. These capabilities include: +Amazon Q Developer is a generative artificial intelligence (AI) powered conversational assistant that can help you understand, analyze, and optimize your AWS costs. With Amazon Q Developer, you can ask complex, open-ended questions about your costs and let Q perform the analysis on your behalf. Q explores your cost data, forms and tests hypotheses, gathers information from multiple sources, performs calculations, and provides actionable insights, all through a natural language conversation. @@ -11 +11 @@ Amazon Q Developer provides powerful capabilities to help you understand and opt - * **Cost analysis** : Analyze your historical and forecasted AWS cost data from Cost Explorer. +Amazon Q Developer helps you get deeper cost insights with less time and expertise. Instead of manually exploring data across multiple tools, adjusting filters, and performing offline calculations, you can delegate the analytical work to Q. This is particularly valuable for teams without dedicated FinOps expertise, as Q reduces the learning curve by handling the complexity of knowing which tools to use, which APIs to call, and how to structure queries. @@ -13 +13 @@ Amazon Q Developer provides powerful capabilities to help you understand and opt - * **Cost optimization** : Identify and implement cost-saving opportunities from Cost Optimization Hub, AWS Compute Optimizer, and Savings Plans and reservation recommendations. +For more information about Amazon Q Developer, see [What is Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/what-is.html) in the _Amazon Q Developer User Guide_. @@ -15 +15 @@ Amazon Q Developer provides powerful capabilities to help you understand and opt - * **Pricing and cost estimation** : Understand AWS service pricing and estimate the cost of new workloads. +## What you can do @@ -16,0 +17 @@ Amazon Q Developer provides powerful capabilities to help you understand and opt +Amazon Q Developer provides powerful capabilities across a wide range of cost management use cases: @@ -17,0 +19 @@ Amazon Q Developer provides powerful capabilities to help you understand and opt +### Understand your costs @@ -18,0 +21 @@ Amazon Q Developer provides powerful capabilities to help you understand and opt +Analyze your historical spending patterns, view cost breakdowns by service or account, and track trends over time. For example, you can ask "What were my costs by service last month?" or "Show me my EC2 spending trends for the past six months." @@ -20 +23 @@ Amazon Q Developer provides powerful capabilities to help you understand and opt -These capabilities use generative AI and large language models (LLMs) to interpret your questions, retrieve relevant cost data, and provide easy-to-understand, conversational responses. With each response, Amazon Q Developer displays the specific API parameters that were used, so you can understand exactly how Amazon Q Developer retrieved your data. Where applicable, it also provides links to matching views in the AWS Management console. If the response isn’t immediately useful, you can ask follow-up questions to expand on the initial response. The cost management capabilities in Amazon Q Developer uses the context from your current conversation to create follow-up responses. +### Investigate cost changes @@ -22 +25 @@ These capabilities use generative AI and large language models (LLMs) to interpr -## Cost analysis +Perform root cause analysis to understand why your costs changed. Q can explore your data, identify the drivers of cost increases or decreases, and help you understand period-over-period changes. For example, you can ask "Why did my costs increase last week?" and Q will investigate the underlying causes. @@ -24 +27 @@ These capabilities use generative AI and large language models (LLMs) to interpr -The cost analysis capability in Amazon Q Developer works with Cost Explorer. You can ask questions about your AWS costs and receive answers in natural language that reflect the actual costs of your AWS account. For example, if you ask Amazon Q Developer a question such as _“What services did I spend the most on last month?”_ , it will provide a response similar to the following: +### Find savings opportunities @@ -26 +29 @@ The cost analysis capability in Amazon Q Developer works with Cost Explorer. You -The AWS services with the highest costs for your account last month were: +Identify cost optimization recommendations from Cost Optimization Hub, AWS Compute Optimizer, and Savings Plans and reservation recommendations. Q can help you find idle resources, rightsizing opportunities, and commitment-based discount opportunities. For example, you can ask "What are my top cost optimization opportunities?" or "Which EC2 instances are over-provisioned?". You can also ask detailed follow-up questions, such as "Tell me more about the second recommendation" or "Why was that EBS volume classified as idle?". @@ -28 +31 @@ The AWS services with the highest costs for your account last month were: - 1. Amazon Relational Database Service: $2,595.55 (36.65% of total cost) +### Monitor cost health @@ -30 +33 @@ The AWS services with the highest costs for your account last month were: - 2. EC2 - Other: $1,222.71 (17.26% of total cost) +Check your budget status, identify cost anomalies, and monitor your free tier usage. Q can alert you to unusual spending patterns and help you stay within your budget targets. For example, you can ask "Have any teams exceeded their budgets?" or "Do I have any cost anomalies?" @@ -32 +35 @@ The AWS services with the highest costs for your account last month were: - 3. Amazon QuickSight: $1,006.32 (14.21% of total cost) +### Estimate future costs @@ -34 +37 @@ The AWS services with the highest costs for your account last month were: - 4. Amazon OpenSearch Service: $695.07 (9.81% of total cost) +Understand AWS service pricing and estimate the cost of new workloads you plan to build. Q can help you compare pricing across regions, calculate costs for specific configurations, and forecast future spending. For example, you can ask "How much would it cost to store 1 PB in S3 in Dublin?" or "What's my cost forecast for this month?" @@ -36 +39 @@ The AWS services with the highest costs for your account last month were: - 5. Amazon ElastiCache: $482.11 (6.81% of total cost) +### Analyze commitment performance @@ -38 +41 @@ The AWS services with the highest costs for your account last month were: - 6. Amazon Elastic Load Balancing: $269.05 (3.80% of total cost) +Review your Savings Plans and Reserved Instances coverage and utilization to understand how effectively you're using commitment-based discounts. Q can identify underutilized commitments and opportunities to improve your discount coverage. For example, you can ask "Analyze our Savings Plans performance over the last month." @@ -40 +43 @@ The AWS services with the highest costs for your account last month were: - 7. AWS Supply Chain: $208.32 (2.94% of total cost) +## How to use it @@ -42 +45 @@ The AWS services with the highest costs for your account last month were: - 8. Amazon Elastic Container Service for Kubernetes: $148.80 (2.10% of total cost) +Amazon Q Developer adapts to however you phrase your questions. You can ask specific, bounded questions when you know exactly what you want, or ask open-ended exploratory questions and let Q investigate on your behalf. @@ -44 +47 @@ The AWS services with the highest costs for your account last month were: - 9. Amazon Virtual Private Cloud: $141.50 (2.00% of total cost) +### Example questions @@ -46 +49 @@ The AWS services with the highest costs for your account last month were: - 10. AWS Glue: $67.57 (0.95% of total cost) +**Specific questions** @@ -47,0 +51 @@ The AWS services with the highest costs for your account last month were: +When you know what data you need, you can ask targeted questions: @@ -48,0 +53 @@ The AWS services with the highest costs for your account last month were: + * "What were my net amortized S3 costs last month?" @@ -49,0 +55 @@ The AWS services with the highest costs for your account last month were: + * "Show me EC2 rightsizing recommendations." @@ -51 +57 @@ The AWS services with the highest costs for your account last month were: -The cost analysis capability uses data from the following Cost Explorer APIs: GetCostAndUsage, GetCostForecast, GetDimensionValues, GetCostCategories, and GetTags. + * "How much does a c8g.2xlarge instance cost in us-east-1?" @@ -53 +58,0 @@ The cost analysis capability uses data from the following Cost Explorer APIs: Ge -## Cost optimization @@ -55 +59,0 @@ The cost analysis capability uses data from the following Cost Explorer APIs: Ge -The cost optimization capability in Amazon Q Developer works with Cost Optimization Hub, AWS Compute Optimizer, and Savings Plans and reservation recommendations. You can ask questions about cost optimization opportunities in your AWS account and receive answers in natural language that reflect actual cost-saving recommendations. For example, if you ask Amazon Q Developer a question such as _“What are my top cost optimization opportunities?”_ it will provide a response similar to the following: @@ -57 +60,0 @@ The cost optimization capability in Amazon Q Developer works with Cost Optimizat -You have substantial opportunities to optimize your AWS costs, with 374 recommendations, totaling $33,479.82, spanning multiple resource types. @@ -59 +62 @@ You have substantial opportunities to optimize your AWS costs, with 374 recommen - 1. EC2 Auto Scaling Groups: $19,412.63 (10 recommendations) +**Open-ended questions** @@ -61 +64 @@ You have substantial opportunities to optimize your AWS costs, with 374 recommen - 2. Compute Savings Plans: $8,788.76 (101 recommendations) +When you want Q to explore and analyze your costs, you can ask broader questions: @@ -63 +66 @@ You have substantial opportunities to optimize your AWS costs, with 374 recommen - 3. RDS DB Instances: $2,160.07 (4 recommendations) + * "Why did my costs increase last week?" @@ -65 +68 @@ You have substantial opportunities to optimize your AWS costs, with 374 recommen - 4. RDS Reserved Instances: $1,666.73 (54 recommendations) + * "Analyze my cost data and give me insights." @@ -67 +70 @@ You have substantial opportunities to optimize your AWS costs, with 374 recommen - 5. OpenSearch Reserved Instances: $335.95 (12 recommendations) + * "What are some easy ways to lower my costs?" @@ -69 +71,0 @@ You have substantial opportunities to optimize your AWS costs, with 374 recommen - 6. EBS Volumes: $293.48 (22 recommendations) @@ -71 +72,0 @@ You have substantial opportunities to optimize your AWS costs, with 374 recommen - 7. ElastiCache Reserved Instances: $259.62 (6 recommendations) @@ -73 +73,0 @@ You have substantial opportunities to optimize your AWS costs, with 374 recommen - 8. EC2 Instances: $153.28 (2 recommendations) @@ -75 +75 @@ You have substantial opportunities to optimize your AWS costs, with 374 recommen - 9. RDS DB Instance Storage: $150.00 (1 recommendation) +**Multi-step analytical questions** @@ -77 +77 @@ You have substantial opportunities to optimize your AWS costs, with 374 recommen - 10. SageMaker Savings Plans: $137.20 (12 recommendations) +Q can handle complex questions that require gathering data from multiple sources and performing calculations: @@ -79 +79 @@ You have substantial opportunities to optimize your AWS costs, with 374 recommen - 11. ECS Services: $65.71 (2 recommendations) + * "What's my effective cost per EC2 instance hour after Savings Plans discounts?" @@ -81 +81 @@ You have substantial opportunities to optimize your AWS costs, with 374 recommen - 12. DynamoDB Reserved Capacity: $56.38 (148 recommendations) + * "Which accounts had the biggest cost increases and what drove them?" @@ -82,0 +83 @@ You have substantial opportunities to optimize your AWS costs, with 374 recommen + * "Analyze our Savings Plans performance and identify optimization opportunities." @@ -86 +86,0 @@ You have substantial opportunities to optimize your AWS costs, with 374 recommen -The cost optimization capability uses data from the following APIs: @@ -88 +88 @@ The cost optimization capability uses data from the following APIs: - * Cost Optimization Hub: GetRecommendation, ListRecommendations, ListRecommendationSummaries +**Estimation questions** @@ -90 +90 @@ The cost optimization capability uses data from the following APIs: - * Compute Optimizer: GetAutoScalingGroupRecommendations, GetEBSVolumeRecommendations, GetEC2InstanceRecommendations, GetECSServiceRecommendations, GetRDSDatabaseRecommendations, GetLambdaFunctionRecommendations, GetIdleRecommendations, GetEffectiveRecommendationPreferences +Q can help you estimate costs for new workloads or compare pricing across regions: @@ -92 +92 @@ The cost optimization capability uses data from the following APIs: - * Cost Explorer: GetReservationPurchaseRecommendation, GetSavingsPlansPurchaseRecommendation + * "How much would it cost to store 1 PB in S3 in Dublin?" @@ -93,0 +94 @@ The cost optimization capability uses data from the following APIs: + * "What's the monthly cost of a t4g.xlarge RDS instance with Multi-AZ and 300 GB gp2 storage?" @@ -94,0 +96 @@ The cost optimization capability uses data from the following APIs: + * "What would be the price to build a basic three tier web app, with a small EC2 instance, API gateway, a ~5GB SQL database, and a basic JS front-end hosted in CloudFront?" @@ -97 +98,0 @@ The cost optimization capability uses data from the following APIs: -## Pricing and cost estimation @@ -99 +99,0 @@ The cost optimization capability uses data from the following APIs: -The pricing and cost estimation capability in Amazon Q Developer works with the AWS Price List APIs. You can ask questions about the prices of AWS services or the estimated cost of new workloads you plan to build on AWS. For example, you can ask a question such as _“How much would it cost to store 200 TB of data in S3 in Dublin?”_ , and receive an answer similar to the following: @@ -101 +101 @@ The pricing and cost estimation capability in Amazon Q Developer works with the -Here’s the cost breakdown for storing 200 TB of data in Amazon S3 in Dublin (eu-west-1 region): +### Tips for getting the most value @@ -103 +103 @@ Here’s the cost breakdown for storing 200 TB of data in Amazon S3 in Dublin (e -Storage cost for 200 TB in S3 Dublin: +**Use follow-up questions to steer the analysis** @@ -105 +105 @@ Storage cost for 200 TB in S3 Dublin: - * **Monthly cost** : $4,556.80 +Amazon Q Developer maintains context within a conversation, so you can ask follow-up questions to dive deeper or guide the analysis in a specific direction: @@ -107 +107 @@ Storage cost for 200 TB in S3 Dublin: - * **Annual cost** : $54,681.60 + * Initial question: "Why did my costs increase last month?" @@ -108,0 +109 @@ Storage cost for 200 TB in S3 Dublin: + * Follow-up: "Next, check if any Savings Plans expired." @@ -109,0 +111 @@ Storage cost for 200 TB in S3 Dublin: + * Follow-up: "Focus on the EC2." @@ -112 +113,0 @@ Storage cost for 200 TB in S3 Dublin: -Cost breakdown (S3 Standard storage): @@ -114 +114,0 @@ Cost breakdown (S3 Standard storage): - * **First 50 TB (51,200 GB)** : $0.023 per GB = $1,177.60 @@ -116 +116 @@ Cost breakdown (S3 Standard storage): - * **Remaining 150 TB (153,600 GB)** : $0.022 per GB = $3,379.20 +**Be specific when you know what you want** @@ -117,0 +118 @@ Cost breakdown (S3 Standard storage): +While Q can handle open-ended questions, being more specific helps you get answers faster if you know exactly what you are looking for: @@ -118,0 +120 @@ Cost breakdown (S3 Standard storage): + * Instead of: "Tell me about my costs" @@ -119,0 +122 @@ Cost breakdown (S3 Standard storage): + * Try: "What were my net amortized EC2 instance costs in us-east-1 last month?" @@ -121 +123,0 @@ Cost breakdown (S3 Standard storage): -Important considerations: This pricing covers **storage only** for S3 Standard class. Additional costs may include: @@ -123 +124,0 @@ Important considerations: This pricing covers **storage only** for S3 Standard c - * Data transfer fees (ingress/egress) @@ -125 +125,0 @@ Important considerations: This pricing covers **storage only** for S3 Standard c - * API requests (PUT, GET, DELETE operations) @@ -127 +127 @@ Important considerations: This pricing covers **storage only** for S3 Standard c - * Data retrieval charges +**Use key-value pairs for tags and cost categories** @@ -129 +129 @@ Important considerations: This pricing covers **storage only** for S3 Standard c - * Cross-region replication (if used) +When filtering by cost allocation tags or cost categories, if you know the specific keys and values you want to use, you can specify them: @@ -131 +131 @@ Important considerations: This pricing covers **storage only** for S3 Standard c - * Versioning storage (if enabled) + * Instead of: "How much did we spend in prod last month?" @@ -132,0 +133 @@ Important considerations: This pricing covers **storage only** for S3 Standard c + * Try: "What was last month's spend for tag key='Environment', value='Production'?" @@ -136 +136,0 @@ Important considerations: This pricing covers **storage only** for S3 Standard c -The S3 Standard storage class provides immediate access to your data with high durability and availability. If you don't need immediate access to all your data, you could consider other storage classes like S3 Intelligent-Tiering, S3 Standard-IA, or S3 Glacier for potential cost savings. @@ -138 +138,46 @@ The S3 Standard storage class provides immediate access to your data with high d -The pricing and cost estimation capability uses data from the following AWS Price List APIs: DescribeServices, GetAttributeValues, GetProducts. +## User experience + +### Transparency + +With each response, Amazon Q Developer provides transparency into how it arrived at its answer: + + * **API calls displayed** : Q shows you the details of each API call it makes, including the exact parameters used. This allows you to understand precisely what data Q retrieved. + + * **Console deep-links** : Where available, Q provides links to matching views in the AWS Management Console, so you can verify the data or explore further. + + + + +This transparency helps you build trust in Q's responses and gives you the information you need to provide more specific instructions in follow-up questions.