AWS AmazonCloudWatch documentation change
Summary
Renamed 'Amazon Q Developer operational investigations' to 'CloudWatch investigations', removed region availability list, added concurrency limits (2 concurrent investigations/150 monthly), updated opt-out policy details, and added cross-account investigation documentation.
Security assessment
The changes primarily involve rebranding and service capability updates rather than addressing specific security vulnerabilities. The added cross-account investigation documentation relates to functionality rather than security controls. The opt-out policy update maintains existing privacy controls but doesn't introduce new security features.
Diff
diff --git a/AmazonCloudWatch/latest/monitoring/Investigations.md b/AmazonCloudWatch/latest/monitoring/Investigations.md index 77dc4fec3..0db80febb 100644 --- a//AmazonCloudWatch/latest/monitoring/Investigations.md +++ b//AmazonCloudWatch/latest/monitoring/Investigations.md @@ -5 +5 @@ -# Amazon Q Developer operational investigations (Preview) +# CloudWatch investigations @@ -7 +7 @@ -###### Note +The CloudWatch investigations feature is a generative AI-powered assistant that can help you respond to incidents in your system. It uses generative AI to scan your system's telemetry and quickly surface suggestions that might be related to your issue. These suggestions include metrics, logs, deployment events, and root-cause hypotheses. For a complete list of types of data that the AI assistant can surface, see [Insights that CloudWatch investigations can surface in investigations](./Investigations-SuggestionTypes.html) @@ -9 +9 @@ -The Amazon Q Developer operational investigations feature is in preview release and is subject to change. It is currently available in the following Regions: +For each suggestion, you decide whether to add it to the investigation findings or to discard it. This helps CloudWatch investigations refine and iterate toward the root cause of the issue. CloudWatch investigations can help you find the root cause without having to manually identify and query multiple metrics and other sources of telemetry and events. A troubleshooting issue that would have taken hours of searching and switching between different consoles can be solved in a much shorter time. @@ -11,30 +11 @@ The Amazon Q Developer operational investigations feature is in preview release - * US East (N. Virginia) - - * US East (Ohio) - - * US West (Oregon) - - * Asia Pacific (Hong Kong) - - * Asia Pacific (Mumbai) - - * Asia Pacific (Singapore) - - * Asia Pacific (Sydney) - - * Asia Pacific (Tokyo) - - * Europe (Frankfurt) - - * Europe (Ireland) - - * Europe (Spain) - - * Europe (Stockholm) - - - - -The Amazon Q Developer operational investigations feature is a generative AI-powered assistant that can help you respond to incidents in your system. It uses generative AI to scan your system's telemetry and quickly surface suggestions that might be related to your issue. These suggestions include metrics, logs, deployment events, and root-cause hypotheses. For a complete list of types of data that the AI assistant can surface, see [Insights that Amazon Q Developer can surface in investigations](./Investigations-SuggestionTypes.html) - -For each suggestion, you decide whether to add it to the investigation findings or to discard it. This helps Amazon Q Developer refine and iterate toward the root cause of the issue. Amazon Q Developer can help you find the root cause without having to manually identify and query multiple metrics and other sources of telemetry and events. A troubleshooting issue that would have taken hours of searching and switching between different consoles can be solved in a much shorter time. +CloudWatch investigations provide intuitive real-time and natural-language analyses and summaries, helps you to understand your system’s status with clear suggestions, and guides you through targeted troubleshooting steps tailored to your specific AWS workloads. @@ -46 +17 @@ You can create investigations in three ways: - * By asking a question in Amazon Q chat. The question could be something like "Why is my Lambda function slow today?" or "What's wrong with my database?" + * By following a prompt in chat with Amazon Q. You can start by asking questions like "Why is my Lambda function slow today?" or "What's wrong with my database?" @@ -53 +24,3 @@ You can create investigations in three ways: -After you start an investigation with any of these methods, Amazon Q Developer scans your system to find telemetry that might be relevant to the situation, and also generates hypotheses based on what it finds. Amazon Q Developer surfaces both the telemetry data and the hypotheses, and enables you to accept or discard each one. +After you start an investigation with any of these methods, CloudWatch investigations scans your system to find telemetry that might be relevant to the situation, and also generates hypotheses based on what it finds. CloudWatch investigations surfaces both the telemetry data and the hypotheses, and enables you to accept or discard each one. + +Each account may have up to 2 concurrent investigations. Only investigations with active analysis count towards this limit. Each month, each account may create up to 150 investigations with AI analysis. @@ -57 +30 @@ After you start an investigation with any of these methods, Amazon Q Developer s -To help Amazon Q Developer operational investigations (Preview) provide the most relevant information, we might use certain content from Amazon Q, including but not limited to questions that you ask Amazon Q and its response, insights, user interactions, telemetry, and metadata for service improvements. Your trust and privacy, as well as the security of your content, is our highest priority. For more information, see [**AWS Service Terms**](https://aws.amazon.com/service-terms/) and [**AWS responsible AI policy**](https://aws.amazon.com/ai/responsible-ai/policy/). +To help CloudWatch investigations provide the most relevant information, we might use certain content from CloudWatch investigations, including but not limited to, questions that you ask CloudWatch investigations and its response, insights, user interactions, telemetry, and metadata for service improvements. Your trust and privacy, as well as the security of your content, is our highest priority. For more information, see [**AWS Service Terms**](https://aws.amazon.com/service-terms/) and [**AWS responsible AI policy**](https://aws.amazon.com/ai/responsible-ai/policy/). @@ -59 +32 @@ To help Amazon Q Developer operational investigations (Preview) provide the most -You can opt out of having your content collected to develop or improve the quality of Amazon Q Developer operational investigations (Preview) by creating an AI service opt-out policy for either Amazon Q or CloudWatch. For more information, see [AI services opt-out policies](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html) in the AWS Organizations User Guide. +You can opt out of having your content collected to develop or improve the quality of CloudWatch investigations by creating an AI service opt-out policy for CloudWatch or AI Operations (aiops). For more information, see [AI services opt-out policies](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html) in the AWS Organizations User Guide. @@ -61 +34 @@ You can opt out of having your content collected to develop or improve the quali -**How investigations find data for suggestions** +**How CloudWatch investigations find data for suggestions** @@ -63 +36 @@ You can opt out of having your content collected to develop or improve the quali -Investigations use a wide range of data sources to determine dependency relationships and plan analysis paths, including telemetry data configurations, service configurations, and observed relationships. These dependency relationships are found more easily if you use CloudWatch Application Signals and AWS X-Ray. When Application Signals and X-Ray aren't available, Amazon Q Developer will attempt to infer dependency relationships through co-occurring telemetry anomalies. +CloudWatch investigations use a wide range of data sources to determine dependency relationships and plan analysis paths, including telemetry data configurations, service configurations, and observed relationships. These dependency relationships are found more easily if you use CloudWatch Application Signals and AWS X-Ray. When Application Signals and X-Ray aren't available, CloudWatch investigations will attempt to infer dependency relationships through co-occurring telemetry anomalies. @@ -65 +38 @@ Investigations use a wide range of data sources to determine dependency relation -While Amazon Q Developer will continue to analyze telemetry data and provide suggestions without these features enabled, in order to ensure optimal quality and performance for Amazon Q Developer operational investigations, we strongly recommend that you enable the services and features listed in [(Recommended) Best practices to enhance investigations](./Investigations-RecommendedServices.html). +While CloudWatch investigations will continue to analyze telemetry data and provide suggestions without these features enabled, in order to ensure optimal quality and performance for CloudWatch investigations, we strongly recommend that you enable the services and features listed in [(Recommended) Best practices to enhance investigations](./Investigations-RecommendedServices.html). @@ -67 +40 @@ While Amazon Q Developer will continue to analyze telemetry data and provide sug -**Costs associated with Amazon Q Developer operational investigations** +**Costs associated with CloudWatch investigations** @@ -69 +42 @@ While Amazon Q Developer will continue to analyze telemetry data and provide sug -The Amazon Q Developer operational investigations feature is provided at no additional cost while in Preview release. During investigations, Amazon Q Developer might incur AWS service usage including telemetry and resource queries and other API usage. While the majority of these will not be charged to your AWS bill, there are exceptions including but not limited to CloudWatch APIs (`ListMetrics`, `GetDashboard`, `ListDashboards`, and `GetInsightRuleReport`), X-Ray APIs (`GetServiceGraph`, `GetTraceSummaries`, and `BatchGetTraces`). Amazon Q Developer also uses AWS Cloud Control APIs which might incur usage of AWS services such as Amazon Kinesis Data Streams and AWS Lambda. Additionally, integration with Amazon Q Developer in chat applications which might incur usage of Amazon Simple Notification Service. For usage of these services exceeding the AWS Free Tier, you will see charges on your AWS bill. These charges are expected to be minimal for normal usage of Amazon Q Developer operational investigations. For more information, see [Amazon Kinesis Data Streams pricing](https://aws.amazon.com/kinesis/data-streams/pricing/), [AWS Lambda pricing for Automation](https://aws.amazon.com/lambda/pricing/), and [Amazon Simple Notification Service pricing](https://aws.amazon.com/sns/pricing/). +CloudWatch investigations may incur AWS service usage including telemetry and resource queries and other API usage. While the majority of these will not be charged to your AWS bill, there are exceptions including but not limited to CloudWatch APIs (`ListMetrics`, `GetDashboard`, `ListDashboards`, and `GetInsightRuleReport`), X-Ray APIs (`GetServiceGraph`, `GetTraceSummaries`, and `BatchGetTraces`). CloudWatch investigations also uses AWS Cloud Control APIs which might incur usage of AWS services such as Amazon Kinesis Data Streams and AWS Lambda. Additionally, integration with CloudWatch investigations in chat applications which might incur usage of Amazon Simple Notification Service. For usage of these services exceeding the AWS Free Tier, you will see charges on your AWS bill. These charges are expected to be minimal for normal usage of CloudWatch investigations. For more information, see [Amazon Kinesis Data Streams pricing](https://aws.amazon.com/kinesis/data-streams/pricing/), [AWS Lambda pricing for Automation](https://aws.amazon.com/lambda/pricing/), and [Amazon Simple Notification Service pricing](https://aws.amazon.com/sns/pricing/). @@ -81 +54,3 @@ The Amazon Q Developer operational investigations feature is provided at no addi - * [Security in operational investigations](./Investigations-Security.html) + * [Cross-account investigations](./Investigations-cross-account.html) + + * [Security in CloudWatch investigations](./Investigations-Security.html) @@ -89 +64 @@ The Amazon Q Developer operational investigations feature is provided at no addi - * [Operational investigation data retention](./Investigations-Retention.html) + * [CloudWatch investigations data retention](./Investigations-Retention.html) @@ -91 +66 @@ The Amazon Q Developer operational investigations feature is provided at no addi - * [Insights that Amazon Q Developer can surface in investigations](./Investigations-SuggestionTypes.html) + * [Insights that CloudWatch investigations can surface in investigations](./Investigations-SuggestionTypes.html)