本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
記錄的查詢
本文件主題是針對支援 Grafana 8.x 版的 Grafana 工作區所設計。
如需支援 Grafana 10.x 版的 Grafana 工作區,請參閱。在 Grafana 第 10 版工作
如需支援 Grafana 9.x 版的 Grafana 工作區,請參閱。在 Grafana 第 9 版中工作
您可以使用記錄的查詢以設定的間隔拍攝資料點的快照,以查看隨時間推移的趨勢。這可以讓您深入了解歷史趨勢。
對於不返回時間序列的插件,繪製歷史數據可能很有用。例如,您可能想要查詢以查看請求ServiceNow回應時間的歷史記錄,但它只能傳回目前的 point-in-time 量度。
記錄的查詢如何運作
記錄的查詢僅適用於後端資料來源外掛程式。如需詳細資訊,請參閱後端資料來源外掛程式
-
單列與欄-傳回單一資料列與欄的查詢。
-
row count-返回有意義的行進行計數的查詢。
-
表達式-任何表達式。若要深入瞭解如何建立和使用表示式,請參閱運算式
。
建立或啟用記錄的查詢之後,它會立即建立快照,並以設定的間隔繼續建立快照。記錄的查詢停止拍攝快照時,它被禁用,刪除,或當 Grafana 沒有運行。通過運行記錄的查詢並將每個結果轉發到遠程寫入啟用 Prometheus 實例來收集數據點在後端。
注意
您必須先設定 Prometheus 資料來源,並將其與遠端寫入目標產生關聯,才能使用記錄的查詢。
建立記錄的查詢
若要建立記錄的查詢,請完成以下步驟:
-
在編輯面板的管控面板上尋找或建立您要記錄的查詢。查詢必須只返回一個行和列。如果返回更多,您仍然可以使用 count 選項記錄返回的結果數。查詢的資料來源必須是後端資料來源。運算式可用於從時間序列查詢彙總資料。若要深入瞭解如何建立和使用運算式,請參閱運算式
。 -
選擇查詢編輯器中的記錄查詢功能表。
-
輸入記錄的查詢資訊。除非另有說明,否則所有欄位皆為必填
-
名稱-記錄查詢的名稱。
-
描述-(選擇性) 如您希望記錄的查詢顯示在已錄製的查詢清單中時,描述該查詢。
-
間隔-擷取快照的間隔。間隔會在您建立記錄的查詢時開始,如果您暫停或刪除記錄的查詢,則會停止。如需暫停和刪除記錄查詢的詳細資訊,請參閱管理記錄的查詢
。 -
範圍-查詢的相對時間範圍。如果您選取 30m 的範圍和間隔為 1 小時,則查詢會在過去 30 分鐘的每小時擷取快照。
-
計算查詢結果-如果要計算查詢返回的行,請打開此選項。如果此選項為關閉,您的查詢必須返回一個具有一個值的行。
-
-
通過選擇測試記錄的查詢按鈕來測試您記錄的查詢。
-
選擇開始錄製查詢。
新增記錄的查詢
您可以將既有已記錄的查詢加入至管控面板中的面板。對於您新增的每個已記錄的查詢,都會建立 Prometheus 查詢:。generated_recorded_query_name{id="generated_id", name="recorded query
name"}
從 Prometheus 創建的查詢返回所有記錄的查詢收集的快照。
-
導覽至管控面板中要新增記錄查詢的面板。
-
選擇 + 記錄的查詢菜單。
-
如果要依資料來源篩選記錄的查詢,請從 [依資料來源篩選] 下拉式功能表中選取資料來源。
-
在錄製的查詢上選擇「新增」選單,將其新增至面板。
將錄製的查詢添加到面板後,面板數據源將變為-- Mixed --
。您記錄的查詢會以名稱標籤與您記錄的Prometheus
查詢名稱相符的查詢來表示。請參閱 Prometheus 以了解有關 Prometheus
如果在新增記錄的查詢之後,會出現包含-- Mixed --
資料來源而非 Prometheus 資料來源的查詢,這可能表示Prometheus
遠端寫入目標並未設定用於記錄的查詢。如需設定遠端寫入點,請參閱遠端寫入目
使用記錄的查詢
若要使用記錄的查詢,請建立查詢並將其新增至儀表板。之後,可以在「首選項」中對其進行管理記錄的查詢選項卡。
管理記錄的查詢
您可以從「偏好設定」的「已記錄的查詢」標籤中暫停或啟用和刪除已記錄的查詢。刪除記錄的查詢會將其從 Grafana 中刪除,但是在 Prometheus 中收集的信息仍然存在。暫停記錄的查詢將不會再收集新的資料點,直到它恢復為止。
遠端寫入目標
遠程寫入目標是記錄查詢數據點被寫入到的 Prometheus 數據源。您將需要一個啟用遠程寫入的 Prometheus,您將需要為此 Prometheus 創建一個數據源。
若要編輯遠端寫入目標,請在偏好設定中的 [記錄的查詢] 索引標籤的主控台功能表中選擇 [編輯遠端寫入 選取啟用遠端寫入的 Prometheus 資料來源,然後輸入遠端寫入路徑。