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

# 記錄的查詢
<a name="recorded-queries"></a>

****  
本文件主題專為支援 Grafana **8.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 12.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 12 版](using-grafana-v12.md)。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 9 版](using-grafana-v9.md)。

您可以使用錄製的查詢，在設定的間隔中擷取資料點的快照，以查看一段時間內的趨勢。這可讓您深入了解歷史趨勢。

對於未傳回時間序列的外掛程式，繪製歷史資料可能很有用。例如，您可能想要查詢 **ServiceNow** 以查看請求回應時間的歷史記錄，但只能傳回目前的point-in-time指標。

## 記錄的查詢如何運作
<a name="how-recorded-queries-work"></a>

記錄的查詢僅適用於後端資料來源外掛程式。如需詳細資訊，請參閱[後端資料來源外掛程式](https://grafana.com/tutorials/build-a-data-source-backend-plugin/)。您可以記錄三種類型的查詢：
+ 單一資料列和資料欄 - 傳回單一資料列和資料欄的查詢。
+ 列計數 - 傳回要計數之有意義的列的查詢。
+ expression - 任何表達式。若要進一步了解如何建立和使用表達式，請參閱[表達式](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/)。

建立或啟用記錄的查詢後，它會立即建立快照，並在設定的間隔繼續建立快照。停用、刪除或 Grafana 未執行時，記錄的查詢會停止擷取快照。透過執行記錄的查詢並將每個結果轉送到啟用遠端寫入的 Prometheus 執行個體，在後端收集資料點。

**注意**  
您必須設定 Prometheus 資料來源，並將其與遠端寫入目標建立關聯，才能使用記錄的查詢。

## 建立記錄的查詢
<a name="create-a-recorded-query"></a>

若要建立記錄的查詢，請完成下列步驟：

1. 在編輯面板中尋找或建立您要在儀表板上記錄的查詢。查詢只能傳回一個資料列和資料欄。如果傳回更多，您仍然可以使用*計數*選項記錄傳回的結果數目。查詢的資料來源必須是後端資料來源。運算式可用來彙總時間序列查詢中的資料。若要進一步了解如何建立和使用表達式，請參閱[表達式](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/)。

1. 選擇位於**查詢編輯器中的記錄**查詢功能表。

1. 輸入記錄的查詢資訊。除非另有說明，否則所有欄位都是必要的。
   + 名稱 - 所記錄查詢的名稱。
   + 描述 - （選用） 將記錄的查詢描述為您希望它出現在記錄的查詢清單中。
   + 間隔 - 拍攝快照的間隔。間隔會在您建立記錄的查詢時開始，並在您暫停或刪除記錄的查詢時停止。如需暫停和刪除已記錄查詢的詳細資訊，請參閱[管理已記錄的查詢](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#manage-recorded-queries)。
   + 範圍 - 查詢的相對時間範圍。如果您選擇範圍為 30 公尺且間隔為 1 小時，查詢將在過去 30 分鐘內每小時拍攝快照。
   + 計數查詢結果 - 如果您想要計算查詢傳回的資料列數，請開啟此選項。如果此選項關閉，您的查詢必須傳回一個包含一個值的資料列。

1. 選擇測試記錄的查詢按鈕來測試記錄的查詢。

1. 選擇**開始記錄查詢**。

## 新增記錄的查詢
<a name="Adding-a-recorded-query"></a>

您可以將現有的記錄查詢新增至儀表板中的面板。針對您新增的每個記錄查詢，會建立 Prometheus 查詢：`generated_recorded_query_name{id="generated_id", name="recorded query name"}`。從 Prometheus 建立的查詢會傳回所有記錄查詢的收集快照。

1. 導覽至儀表板中您要新增已記錄查詢的面板。

1. 選擇 **\+ 記錄的查詢**功能表。

1. 如果您想要依資料來源篩選記錄的查詢，請從依資料來源篩選的下拉式選單中選取資料來源。

1. 在記錄的查詢上選擇**新增**功能表，將其新增至面板。

將錄製的查詢新增至面板後，面板資料來源會變成 `-- Mixed --`。您記錄的查詢由具有符合您記錄`Prometheus`查詢名稱之名稱標籤的查詢表示。請參閱 [Prometheus](https://grafana.com/docs/grafana/latest/datasources/prometheus/) 以進一步了解 Prometheus 資料來源。

如果在新增記錄的查詢後，出現具有`-- Mixed --`資料來源而非 Prometheus 資料來源的查詢，這可能表示未為記錄的查詢設定`Prometheus `遠端寫入目標。請參閱[遠端寫入目標](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#remote-write-target)以設定遠端寫入點。

## 使用記錄的查詢
<a name="using-a-recorded-query"></a>

若要使用記錄的查詢，請建立一個查詢並將其新增至儀表板。之後，它可以在**偏好設定**中從**已記錄的查詢**索引標籤進行管理。

## 管理記錄的查詢
<a name="managing-recorded-queries"></a>

記錄的查詢可以暫停或啟用，並從偏好設定中的記錄的查詢索引標籤中刪除。刪除記錄的查詢會從 Grafana 中移除，但 Prometheus 中收集的資訊仍然存在。暫停記錄的查詢將不再收集新的資料點，直到繼續為止。

## 遠端寫入目標
<a name="remote_write_target"></a>

遠端寫入目標是記錄查詢資料點的 **Prometheus** 資料來源。您需要啟用遠端寫入的 Prometheus，而且需要為此 Prometheus 建立資料來源。

若要編輯遠端寫入目標，請在**偏好設定****中錄音查詢**索引標籤的主控台選單中選擇**編輯遠端寫入目標**。選取已啟用遠端寫入的 **Prometheus** 資料來源，然後輸入遠端寫入路徑。