使用自然语言生成与更新 CloudWatch Metrics Insights 查询 - Amazon CloudWatch
示例查询 选择不使用您的数据来改善服务
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

使用自然语言生成与更新 CloudWatch Metrics Insights 查询

此功能在美国东部（弗吉尼亚州北部）、美国西部（俄勒冈州）和亚太地区（东京）的 CloudWatch 中提供预览版，并且可能会有所更改。

CloudWatch 支持自然语言查询功能，以帮助您生成和更新 CloudWatch Metrics Insights 和 CloudWatch Logs Insights 查询。

通过此功能，您可以用通俗易懂的英语询问或描述要查找的 CloudWatch 数据。自然语言功能可根据您输入的提示生成查询，并逐行说明查询的工作原理。您也可以更新查询以进一步调查数据。

您可以根据环境输入各种提示，例如“Which Amazon Elastic Compute Cloud instance has the highest network out?”（哪个 Amazon Elastic Compute Cloud 实例的网络输出量最高？） 以及“Show me the top 10 Amazon DynamoDB Tables by consumed reads”（展示读取使用量前 10 的 Amazon DynamoDB 表）等。

要生成具有此功能的 CloudWatch Metrics Insights 查询，请在构建器或编辑器视图中打开 CloudWatch Metrics Insights 查询编辑器，然后选择生成查询。

重要

要使用自然语言查询功能，您必须使用 CloudWatchFullAccess、CloudWatchReadOnlyAccess、CloudWatchFullAccessV2、AdministratorAccess 或 ReadOnlyAccess 策略。

您也可以将 cloudwatch:GenerateQuery 操作包含在新的或现有的客户托管策略或内联策略中。

示例查询

本节中的示例描述了如何使用自然语言功能生成和更新查询。

注意

有关 CloudWatch Metrics Insights 查询编辑器和语法的更多信息，请参阅 CloudWatch Metrics Insights 查询组件和语法。

示例：生成自然语言查询

要使用自然语言来生成查询，请输入提示并选择生成新查询。此示例显示了一个执行基本搜索的查询。

提示

在以下示例中，该提示指示的功能可搜索占用最多读取容量的前 10 个 DynamoDB 表格。

Show top 10 DynamoDB Tables by consumed reads
查询

以下是自然语言功能根据提示生成的查询示例。请注意在查询之前的注释中，提示是如何显示的。查询完成后，您可以阅读有关查询工作原理的说明。

# Show top 10 DynamoDB Tables by consumed reads
SELECT SUM("ConsumedReadCapacityUnits")
FROM "AWS/DynamoDB"
GROUP BY TableName
ORDER BY SUM() DESC
LIMIT 10
# This query selects the sum of consumed read capacity units for each DynamoDB table, groups the results by table name, orders the results from highest to lowest read capacity consumption, and limits the results to the top 10 tables.
注意

要关闭提示和有关查询工作原理的说明显示，请使用编辑器中的齿轮图标。

示例：更新自然语言查询

您可以通过编辑初始提示，然后选择更新查询，来更新查询。

更新版提示

以下示例显示了先前提示的更新版本。现在，该提示不再搜索占用读取容量最多的前 10 个 DynamoDB 表格，而是按返回的字节数对结果进行排序。

Sort by bytes returned instead
更新版查询

以下是更新版查询的示例：请注意在更新版查询之前的注释中，更新版提示是如何显示的。查询完成后，您可以阅读有关原始查询是如何更新的说明。

# Sort by bytes returned instead
SELECT SUM("ReturnedBytes")
FROM "AWS/DynamoDB"
GROUP BY TableName
ORDER BY SUM() DESC
LIMIT 10
# This query modifies the original query to select the sum of returned bytes instead of consumed read capacity units, and orders the results from highest to lowest sum of returned bytes, limiting the results to the top 10 tables.

选择不使用您的数据来改善服务

您为训练 AI 模型和生成相关查询而提供的自然语言提示数据仅用于提供和维护您的服务。这些数据可用于提高 CloudWatch Metrics Insights 的质量。您的信任、隐私和内容的安全性是我们最重视的问题。有关更多信息，请参阅 Amazon Service Terms 和 Amazon responsible AI policy。

通过创建 AI 服务选择退出策略，您可以选择不将您的内容用于开发自然语言查询或提高自然语言查询的质量。要选择退出对所有 CloudWatch AI 功能（包括查询生成功能）进行的数据收集，您必须为 CloudWatch 创建一个选择退出策略。有关更多信息，请参阅《Amazon Organizations 用户指南》中的 AI 服务选择退出策略。