AWS amazonq documentation change
Summary
Restructured and expanded documentation for Amazon Q Developer's cost management capabilities. Added sections explaining 'What you can do', 'How it works', and 'Getting started', with detailed examples and integration points with AWS services like Cost Explorer and Cost Optimization Hub. Removed standalone prerequisites section and integrated requirements into new structure.
Security assessment
The changes focus on improving user guidance and expanding feature documentation. While IAM permissions are mentioned in the 'Getting started' section, this is a standard access control requirement rather than addressing a specific security vulnerability. No evidence of patching a security issue or introducing new security controls.
Diff
diff --git a/amazonq/latest/qdeveloper-ug/chat-costs.md b/amazonq/latest/qdeveloper-ug/chat-costs.md index 4d163685d..5afcfd25d 100644 --- a//amazonq/latest/qdeveloper-ug/chat-costs.md +++ b//amazonq/latest/qdeveloper-ug/chat-costs.md @@ -5 +5 @@ -PrerequisitesExample questions +What you can doHow it worksGetting startedExample questions @@ -9 +9 @@ PrerequisitesExample questions -You can ask Amazon Q about your historical and forecasted AWS cost data as well as how to optimize your costs. Amazon Q can retrieve your cost data, explain costs, and analyze cost trends, so you can understand your costs without referring to documentation or interrupting your workflow. Amazon Q can also provide recommendations on how to optimize your AWS costs, including rightsizing instances, stopping or deleting idle or unused resources, migrating EC2 instances to AWS Graviton-based instances, and purchasing Savings Plans. +Amazon Q Developer is a generative artificial intelligence (AI) powered conversational assistant that can help you understand, build, extend, and operate AWS applications. Amazon Q Developer provides powerful capabilities to help you manage your AWS costs through natural conversation. You can analyze your historical and forecasted costs from Cost Explorer, discover cost-saving recommendations from Cost Optimization Hub and AWS Compute Optimizer, understand Savings Plans and reservation opportunities, and get instant answers about AWS product attributes or service pricing. Amazon Q Developer can both answer specific questions (e.g., "What were net unblended costs for EC2 instances last month?") or perform complex or open-ended analysis (e.g., "What were the biggest drivers of last week's cost decrease?"). Amazon Q Developer transforms how you interact with AWS cost data by letting you ask questions in your own words instead of learning query syntax or navigating multiple console pages, while providing precise answers backed by real data from your AWS account and showing exactly which APIs were called and where to find the information in the console. @@ -11 +11 @@ You can ask Amazon Q about your historical and forecasted AWS cost data as well -When you ask Amazon Q about your costs, its response includes the specific parameters used to retrieve the data, as well as a link to learn more in the AWS Management Console. +For more information about the cost management capabilities in Amazon Q Developer, see [Managing your costs using generative AI with Amazon Q Developer](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-cost-analysis-q.html) in the _AWS Cost Management User Guide_. @@ -13 +13 @@ When you ask Amazon Q about your costs, its response includes the specific param -For more information about cost analysis in Amazon Q, see [Analyzing and optimizing your costs using generative AI with Amazon Q Developer](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-cost-analysis-q.html) in the _AWS Cost Management User Guide_. +## What you can do @@ -15 +15 @@ For more information about cost analysis in Amazon Q, see [Analyzing and optimiz -## Prerequisites +With Amazon Q Developer, you can: @@ -17 +17 @@ For more information about cost analysis in Amazon Q, see [Analyzing and optimiz -You can chat about your AWS costs in the AWS Management Console and in [configured chat applications](./q-in-chat-applications.html). + * **Analyze your costs** – Ask questions about your historical spending patterns, cost trends, and forecasted costs. For example, "What were my EC2 costs last month?" or "Why did my costs increase last week?" @@ -19 +19 @@ You can chat about your AWS costs in the AWS Management Console and in [configur -For Amazon Q to answer questions about your costs, the following prerequisites must be met. + * **Find optimization opportunities** – Discover ways to reduce your AWS spending by asking about recommendations from Cost Optimization Hub, AWS Compute Optimizer, and Savings Plans. For example, "What are my top cost optimization opportunities?" or "Which EC2 instances are over-provisioned?" @@ -21 +21 @@ For Amazon Q to answer questions about your costs, the following prerequisites m -### Add permissions + * **Understand pricing** – Get instant answers about AWS service pricing. For example, "How much does a c8g.2xlarge instance cost in us-east-1?" or "What would it cost to store 1 PB in S3 in Dublin?" @@ -23 +22,0 @@ For Amazon Q to answer questions about your costs, the following prerequisites m -To chat about your costs, your IAM identity must have permissions to chat with Amazon Q, access your billing data, and retrieve cost optimization recommendations. For an IAM policy that grants the required permissions, see [Allow Amazon Q to access cost data and provide cost optimization recommendations](./id-based-policy-examples-users.html#id-based-policy-examples-allow-cost-chat). @@ -25 +23,0 @@ To chat about your costs, your IAM identity must have permissions to chat with A -### Enable AWS Cost Explorer and AWS Cost Optimization Hub @@ -27 +24,0 @@ To chat about your costs, your IAM identity must have permissions to chat with A -To chat about your costs with Amazon Q, you must enable AWS Cost Explorer in your AWS account. To enable Cost Explorer, open the Cost Explorer console. For more information, see [Enabling Cost Explorer](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-enable.html) in the _AWS Cost Management User Guide_. @@ -29 +26,37 @@ To chat about your costs with Amazon Q, you must enable AWS Cost Explorer in you -To receive cost optimization recommendations from Amazon Q, you must enable AWS Cost Optimization Hub. For more information, see [Getting started with Cost Optimization Hub](https://docs.aws.amazon.com/cost-management/latest/userguide/cost-optimization-hub-getting-started.html) in the _AWS Cost Management User Guide_. +Amazon Q Developer adapts to however you phrase your questions. You can ask specific questions when you know exactly what you want, or ask open-ended exploratory questions and let Q investigate on your behalf. Q maintains context throughout your conversation, so you can ask follow-up questions to dive deeper or guide the analysis in a specific direction. + +## How it works + +When you ask Amazon Q Developer about your costs, Q retrieves data from AWS Cost Explorer, Cost Optimization Hub, AWS Compute Optimizer, and other AWS services. Q performs calculations, analyzes patterns, and provides insights based on your actual usage and spending data. With each response, Q provides transparency into how it arrived at its answer by showing you the API calls it made, the parameters used, and links to matching views in the AWS Management Console where available. This helps you verify the data and explore further. + +## Getting started + +To chat about your AWS costs, you need: + + * **Appropriate IAM permissions** – Your IAM identity must have permissions to chat with Amazon Q and access your billing data. For an IAM policy that grants the required permissions, see [Allow Amazon Q to access cost data and provide cost optimization recommendations](./id-based-policy-examples-users.html#id-based-policy-examples-allow-cost-chat). + + * **Cost Explorer opt-in** – You must enable AWS Cost Explorer in your AWS account. To enable Cost Explorer, open the [Cost Explorer console](https://console.aws.amazon.com/costmanagement/home#/cost-explorer). For more information, see [Enabling Cost Explorer](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-enable.html) in the _AWS Cost Management User Guide_. + + + + +To take advantage of the full range of Amazon Q Developer's cost management capabilities, you can also enable additional services such as AWS Cost Optimization Hub or AWS Budgets. To learn more, see [Overview of cost management capabilities in Amazon Q Developer](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-q-overview.html) in the _AWS Cost Management User Guide_. + +To get started: + + 1. Sign in to the AWS Management Console at [https://console.aws.amazon.com](https://console.aws.amazon.com). + + 2. Choose the Amazon Q icon on the right side of the console navigation bar. + + 3. Ask a question about your costs, such as: + + * "What were my costs last month?" + + * "What are my top cost optimization opportunities?" + + * "How much does a c8g.2xlarge instance running Linux cost in us-east-1?" + + + + +You can also configure Amazon Q Developer in chat applications such as Slack and Microsoft Teams. For more information about using Amazon Q Developer in chat applications, see [Chatting with Amazon Q Developer in chat applications](./q-in-chat-applications.html). @@ -33 +66,35 @@ To receive cost optimization recommendations from Amazon Q, you must enable AWS -Following are example questions about costs that you can ask Amazon Q: +Following are example questions about costs that you can ask Amazon Q Developer: + +**Cost analysis** + + * "What were my costs last month?" + + * "Show me my EC2 spending trends for the past six months." + + * "What are the top contributing services to my AWS bill in the eu-central-1 region?" + + * "Why did my costs increase last week?" + + * "Analyze my spending data for the last month and give me the most important insights." + + + + +**Cost optimization** + + * "What are my top cost optimization opportunities?" + + * "Which EC2 instances are over-provisioned?" + + * "Do I have any idle resources?" + + * "Which Savings Plans should I purchase?" + + + + +**Budget and anomaly monitoring** + + * "Have any teams exceeded their budgets?" + + * "Do I have any cost anomalies?" @@ -35 +101,0 @@ Following are example questions about costs that you can ask Amazon Q: - * How much did we spend on SageMaker AI in January? @@ -37 +102,0 @@ Following are example questions about costs that you can ask Amazon Q: - * What are the top contributing services to my AWS bill in the `'eu-central-1'` region? @@ -39 +103,0 @@ Following are example questions about costs that you can ask Amazon Q: - * What were my Amazon EC2 costs by instance type last week? @@ -41 +105 @@ Following are example questions about costs that you can ask Amazon Q: - * What was my cost breakdown by service for the past three months? +**Pricing estimation** @@ -43 +107 @@ Following are example questions about costs that you can ask Amazon Q: - * How can I lower my AWS bill? + * "How much does a c8g.2xlarge instance cost in us-east-1?" @@ -45 +109 @@ Following are example questions about costs that you can ask Amazon Q: - * What are my top cost optimization opportunities? + * "What would it cost to store 1 PB in S3 in Dublin?" @@ -47 +111 @@ Following are example questions about costs that you can ask Amazon Q: - * Are any of my Amazon EC2 instances over-provisioned? + * "What's the monthly cost of a t4g.xlarge RDS instance with Multi-AZ and 300 GB gp2 storage?" @@ -49 +113 @@ Following are example questions about costs that you can ask Amazon Q: - * Which Savings Plans should I purchase? + * "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?"