# 在 Query Studio 中运行 PromQL 查询（预览版）
<a name="CloudWatch-PromQL-QueryStudio"></a>

**注意**  
Query Studio 目前以预览版功能的形式提供，不收取额外费用。有关支持的区域，请参阅[支持的 AWS 区域](CloudWatch-PromQL.md#CloudWatch-PromQL-Regions)。

Query Studio 是 CloudWatch 控制台中的一个交互式查询环境，您可以在其中根据 CloudWatch 指标编写、运行和可视化 PromQL 查询。您可以使用 Query Studio 浏览通过 OTLP 摄取的指标和 AWS 已出售指标、创建可视化效果、设置警报以及将小组件添加到 CloudWatch 控制面板中。

您可以使用 CloudWatch API 以编程方式运行 PromQL 查询，也可以在 Query Studio 中以交互方式运行。

## 在 Query Studio 中运行 PromQL 查询
<a name="CloudWatch-PromQL-QueryStudio-RunQuery"></a>

**在 Query Studio 中运行 PromQL 查询**

1. 打开 [CloudWatch 控制台](https://console.aws.amazon.com/cloudwatch/)。

1. 在导航窗格中，请选择 **Query Studio（预览版）**。

1. 在查询编辑器工具中，从下拉菜单中选择 **PromQL**。

1. 使用**生成器**模式浏览和选择指标名称、标签与聚合函数。

1. 或者，通过**编辑器**模式输入 PromQL 查询，例如 `{"http.server.active_requests"}`。

1. （可选）使用页面顶部的时间间隔选择器调整时间范围。

1. 选择**运行**以执行查询并查看结果。

Query Studio 将以时间序列图表的方式显示结果。您可以在图表视图和表格视图之间切换以分析数据。

## 通过 Query Studio 创建警报
<a name="CloudWatch-PromQL-QueryStudio-Alarms"></a>

运行返回单个时间序列的 PromQL 查询后，可以直接通过 Query Studio 创建 CloudWatch 警报。从操作菜单中选择**创建警报**，根据查询结果配置警报阈值、评估期和通知操作。有关更多信息，请参阅 [在警报中使用 PromQL](CloudWatch-PromQL-Alarms.md)。

## 将可视化效果添加到控制面板中
<a name="CloudWatch-PromQL-QueryStudio-Dashboards"></a>

您可以将任何 Query Studio 可视化效果添加到 CloudWatch 控制面板中。运行查询并查看结果后，选择**添加到控制面板**以将可视化效果保存为控制面板小组件。该小组件继续以控制面板的刷新间隔运行 PromQL 查询，使控制面板保持最新状态。