AWS cost-management documentation change
Summary
Expanded documentation to include cost optimization capabilities alongside cost analysis, added detailed examples of cost optimization recommendations, and updated prerequisites with security/permission requirements
Security assessment
The changes add a prerequisite about ensuring appropriate permissions for security compliance, but there is no evidence of addressing a specific security vulnerability. The security documentation addition is about standard access controls rather than patching a security issue.
Diff
diff --git a/cost-management/latest/userguide/ce-q-overview.md b/cost-management/latest/userguide/ce-q-overview.md index d16af89cf..4bcd554ff 100644 --- a//cost-management/latest/userguide/ce-q-overview.md +++ b//cost-management/latest/userguide/ce-q-overview.md @@ -5 +5 @@ -Getting startedPricing +Cost analysisCost optimizationGetting startedPricing @@ -7 +7 @@ Getting startedPricing -# Overview of Amazon Q Developer's cost analysis capability +# Overview of cost management capabilities in Amazon Q Developer @@ -9 +9 @@ Getting startedPricing -Amazon Q Developer’s cost analysis capability is a feature of Amazon Q Developer that works with Cost Explorer. With the cost analysis capability in Amazon Q Developer, you can ask questions about your AWS costs and receive answers in natural language that reflect the actual costs of your AWS services. Amazon Q Developer’s cost analysis capability uses generative AI and large language models (LLMs) to interpret your question, requests the relevant cost data from Cost Explorer, and provides an easy-to-understand, conversational response. With each response, Amazon Q Developer provides transparency on the parameters that were used to retrieve your cost data, as well as a link to a matching visualization in the Cost Explorer console. +Amazon Q Developer provides powerful capabilities to help you understand and optimize your AWS costs. These capabilities include: @@ -11 +11,12 @@ Amazon Q Developer’s cost analysis capability is a feature of Amazon Q Develop -For example, if you ask Amazon Q Developer a question such as _“What services did I spend the most on last month?”_ , it will return a response similar to the following: + * **Cost analysis** : Analyze your historical and forecasted AWS cost data from Cost Explorer. + + * **Cost optimization** : Identify and implement cost-saving opportunities from Cost Optimization Hub, AWS Compute Optimizer, and Savings Plans and reservation recommendations. + + + + +Both 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, and 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 analysis capability in Amazon Q Developer uses the context from your current conversation to create follow-up responses. + +## Cost analysis + +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: @@ -38 +49,17 @@ The AWS services with the highest costs for your account last month were: -_The following Cost Explorer parameters were used to answer your question:_ +The cost analysis capability uses data from the following Cost Explorer APIs: GetCostAndUsage, GetCostForecast, GetDimensionValues, GetCostCategories, and GetTags. + +## Cost optimization + +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: + +You have substantial opportunities to optimize your AWS costs, with 374 recommendations, totaling $33,479.82, spanning multiple resource types. + + 1. EC2 Auto Scaling Groups: $19,412.63 (10 recommendations) + + 2. Compute Savings Plans: $8,788.76 (101 recommendations) + + 3. RDS DB Instances: $2,160.07 (4 recommendations) + + 4. RDS Reserved Instances: $1,666.73 (54 recommendations) + + 5. OpenSearch Reserved Instances: $335.95 (12 recommendations) @@ -40 +67 @@ _The following Cost Explorer parameters were used to answer your question:_ - * Date range: _2024-03-01 through 2024-03-31 (inclusive)_ + 6. EBS Volumes: $293.48 (22 recommendations) @@ -42 +69 @@ _The following Cost Explorer parameters were used to answer your question:_ - * Granularity: _"MONTHLY"_ + 7. ElastiCache Reserved Instances: $259.62 (6 recommendations) @@ -44 +71 @@ _The following Cost Explorer parameters were used to answer your question:_ - * Group-by dimensions: _"Service"_ + 8. EC2 Instances: $153.28 (2 recommendations) @@ -46 +73 @@ _The following Cost Explorer parameters were used to answer your question:_ - * Filter: _Excludes charge types “Refund”, “Credit”_ + 9. RDS DB Instance Storage: $150.00 (1 recommendation) @@ -48 +75 @@ _The following Cost Explorer parameters were used to answer your question:_ - * Metric: _"UnblendedCosts"_ + 10. SageMaker Savings Plans: $137.20 (12 recommendations) @@ -49,0 +77,14 @@ _The following Cost Explorer parameters were used to answer your question:_ + 11. ECS Services: $65.71 (2 recommendations) + + 12. DynamoDB Reserved Capacity: $56.38 (148 recommendations) + + + + +The cost optimization capability uses data from the following APIs: + + * Cost Optimization Hub: GetRecommendation, ListRecommendations, ListRecommendationSummaries + + * Compute Optimizer: GetAutoScalingGroupRecommendations, GetEBSVolumeRecommendations, GetEC2InstanceRecommendations, GetECSServiceRecommendations, GetRDSDatabaseRecommendations, GetLambdaFunctionRecommendations, GetIdleRecommendations, GetEffectiveRecommendationPreferences + + * Cost Explorer: GetReservationPurchaseRecommendation, GetSavingsPlansPurchaseRecommendation @@ -53 +93,0 @@ _The following Cost Explorer parameters were used to answer your question:_ -If the response isn’t immediately useful, you can ask follow-up questions to expand on the initial response. Amazon Q Developer’s cost analysis capability uses the context from your current conversation to create follow-up responses. @@ -57 +97,10 @@ If the response isn’t immediately useful, you can ask follow-up questions to e -To use the cost analysis capability in Amazon Q Developer, you must first opt in to Cost Explorer. To opt in to Cost Explorer, open the Billing and Cost Management console at [https://console.aws.amazon.com/costmanagement/](https://console.aws.amazon.com/costmanagement/). Once you’ve opted in to Cost Explorer, it can take up to 24 hours for your cost data to be available. +**Prerequisites** + + * Ensure you have the appropriate permissions to use Amazon Q Developer, AWS Cost Explorer, AWS Cost Optimization Hub, and AWS Savings Plans and reservation recommendations. For details, see [Security and privacy](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-q-security.html). + + * To use the cost analysis capability in Amazon Q Developer, you must first opt in to Cost Explorer. To opt in to Cost Explorer, open the Billing and Cost Management console at [https://console.aws.amazon.com/costmanagement/](https://console.aws.amazon.com/costmanagement/). Once you’ve opted in to Cost Explorer, it can take up to 24 hours for your cost data to be available. + + * To use the cost optimization capability in Amazon Q Developer, you must first opt in to Cost Optimization Hub. To opt in to Cost Optimization Hub, open the Cost Optimization Hub console page at [https://console.aws.amazon.com/costmanagement/home#/cost-optimization-hub](https://console.aws.amazon.com/costmanagement/home#/cost-optimization-hub), and then choose **Enroll**. Once you’ve opted in to Cost Optimization Hub, it can take up to 24 hours for recommendations to be calculated. + + + @@ -61 +110 @@ To use the cost analysis capability in Amazon Q Developer, you must first opt in - 1. Log in to the AWS Management Console at [https://console.aws.amazon.com](https://console.aws.amazon.com). + 1. Log in to the AWS Management console at [https://console.aws.amazon.com](https://console.aws.amazon.com). @@ -63 +112 @@ To use the cost analysis capability in Amazon Q Developer, you must first opt in - 2. Choose the Amazon Q Developer icon on the right side of the console. + 2. Choose the Amazon Q icon on the right side of the console. @@ -65 +114 @@ To use the cost analysis capability in Amazon Q Developer, you must first opt in - 3. Ask a question about your costs, such as _“What were my costs last month?”_ + 3. Ask a question about your costs, such as _“What were my costs last month?”_ or _“How can I lower my AWS bill?”_. @@ -72 +121 @@ To use the cost analysis capability in Amazon Q Developer, you must first opt in -The cost analysis capability is included with Amazon Q Developer. For information about Amazon Q Developer pricing, see [Amazon Q Developer pricing](https://aws.amazon.com/q/developer/pricing/). +The cost analysis and cost optimization capabilities are included with Amazon Q Developer. For information about Amazon Q Developer pricing, see [Amazon Q Developer pricing](https://aws.amazon.com/q/developer/pricing/). @@ -80 +129 @@ To use the Amazon Web Services Documentation, Javascript must be enabled. Please -Analyzing your cost data with Amazon Q Developer +Analyzing and optimizing your costs with Amazon Q Developer