本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 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. 在導覽窗格中，選擇**查詢 Studio （預覽）**。

1. 在查詢編輯器工具中，從下拉式功能表中選取 **PromQL**。

1. 使用 **Builder** 模式瀏覽並選取指標名稱、標籤和彙總函數。

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 查詢，讓您的儀表板保持在最新狀態。