查詢 - Amazon Managed Grafana
查詢編輯器查詢語法查詢索引標籤 UI在面板之間共用查詢結果

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

查詢

本文件主題是針對支援 Grafana 8.x 版的 Grafana 工作區所設計。

如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱。在 Grafana 第 10 版工作

如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱。在 Grafana 第 9 版中工作

Grafana 工作區面板使用「查詢」與資料來源通訊，以取得視覺效果的資料。查詢是資料來源所使用的查詢語言撰寫的問題。如果查詢格式正確，則資料來源會回應。在面板資料來源選項中，您可以調整將查詢傳送至資料來源的頻率以及收集的資料點數量。

Grafana 工作區最多支援每個面板 26 個查詢。

查詢編輯器

查詢編輯器是可協助您撰寫查詢的表單。根據您的資料來源，查詢編輯器可能會提供自動完成、量度名稱或變數建議。

由於查詢語言之間的差異，資料來源的查詢編輯器可能看起來不同。

查詢語法

資料來源有不同的查詢語言和語法來要求資料。以下是兩個查詢範例。

PostgreSQL 


SELECT hostname FROM host WHERE region IN($region)

PromQL 


query_result(max_over_time(<metric>[${__range_s}s]) != <state>)

有關為資料來源撰寫查詢的詳細資訊，請參閱該資料來源的文件。中列出了資料來源連線至資料來源。

查詢索引標籤 UI

「查詢」(Query) 標籤包含下列元素：

  • 資料來源選取器

  • 查詢選項

  • 查詢檢查器按鈕

  • 查詢編輯器清單

資料來源選取器

資料來源選取器是下拉式清單。選擇它以選取您已新增的資料來源。當您建立面板時，Amazon 受管 Grafana 會自動選取您的預設資料來源。如需資料來源的詳細資訊，請參閱連線至資料來源。

除了您在 Grafana 工作區中設定的資料來源之外，還有三個特殊資料來源可供使用。

  • TestDataDB — 產生隨機漫遊資料的內建資料來源。Grafana 資料來源對於測試視覺效果和執行實驗非常有用。

  • 混合 — 用於在同一面板中查詢多個資料來源的資料來源。選取此資料來源後，您可以為新增的每個新查詢選取資料來源。

    • 第一個查詢將使用在您選取「混合」之前選取的資料來源。

    • 您無法將現有查詢變更為使用混合資料來源。

  • 儀表板-使用相同儀表板中另一個面板中結果集的資料來源。

查詢選項

若要查看所選資料來源的設定，請選擇資料來源選取器旁邊的 [查詢] 選項。您在此處所做的變更只會影響在此面板中進行的查詢。

Amazon 託管 Grafana 設置了以深灰色文本顯示的默認設置。變更會以白色文字顯示。若要將欄位恢復為預設設定，請從欄位中刪除白色文字。

您可以使用下列面板資料來源查詢選項：

  • 最大資料點數 — 如果資料來源支援，則為傳回的每個序列設定最大資料點數。如果查詢傳回的資料點多於「最大資料點」設定，則資料來源會合併這些資料點 (透過按平均值、max 或其他函數將它們彙總在一起，以減少傳回的點數)。

    限制點數的主要原因有兩個：效能和平滑化直線。預設值是圖表的寬度 (或像素數)，這樣可避免擁有比圖形面板顯示更多的資料點。

    對於流數據，最大數據點值用於滾動緩衝區。（流是一種連續的數據流，緩衝是將流分成塊的一種方法）。

  • 最小間隔 — 設定自動計算的間隔的最小限制，通常是最小抓取間隔。如果每 15 秒儲存一次資料點，則不需要比該間隔更低。另一個用例是將其設置為比抓取間隔更高的最小值，以獲得更粗糙，功能良好的查詢。

  • Interval — 依時間彙總或分組資料點時可使用的時間範圍。

    Amazon 受管的 Grafana 會自動計算適當的間隔，該間隔可在範本化查詢中當做變數使用。該變量可以是以秒為單位：$__interval; 或以毫秒為單位：$__interval_ms。它通常用於聚合函數，如sum或average。例如，這是一個使用間隔變量的 Prometheus 查詢：。rate(http_requests_total[$__interval])

    此自動間隔是根據圖形的寬度計算的。如果使用者縮小很多，則間隔會變大，進而產生更粗糙的彙總。如果使用者放大，間隔會減少，進而產生更精細的彙總。

    如需詳細資訊，請參閱 全域變數。

  • 相對時間 — 取代個別面板的相對時間範圍，使其與管控面板右上角的儀表板時間選擇器中選取的內容不同。這可讓您在同一個儀表板上顯示來自不同時段或日期的指標。

  • 時移 — 提供另一種覆寫個別面板時間範圍的方法。此功能僅適用於相對時間範圍，您可以調整時間範圍。

    例如，您可以將面板的時間範圍移至比儀表板時間選擇器早 2 小時。如需詳細資訊，請參閱 時間範圍控制。

  • 「緩存超時」—（此字段僅在數據源中可用時才可見。） 如果您的時間序列存放區具有查詢快取，則會覆寫預設快取逾時。它被指定為以秒為單位的數值。

查詢檢查器按鈕

您可以選擇「查詢檢視器」，開啟面板檢測器的「查詢」索引標籤。在 [查詢] 索引標籤上，您可以看到面板傳送的查詢要求和回應。

選擇「重新整理」以查看此面板傳送至伺服器之要求的完整文字。

注意

在查詢檢查器可以返回結果之前，您需要添加至少一個查詢。

如需有關面板檢測器的詳細資訊，請參閱檢查嵌板。

查詢編輯器清單

在 UI 中，查詢會以可摺疊的查詢列組織。每個查詢列都包含一個查詢編輯器，並以字母 (A、B、C 等) 來識別。

在面板之間共用查詢結果

使用 Amazon 受管的 Grafana，您可以將一個面板的查詢結果用於儀表板中的任何其他面板。跨面板共用查詢結果可減少對資料來源進行的查詢次數，進而改善儀表板的效能。

「儀表板」資料來源可讓您在儀表板中選取包含要共用結果之查詢的面板。Amazon Managed Grafana 不會針對每個面板傳送個別查詢，而是傳送一個查詢，而其他面板則使用查詢結果來建構視覺效果。

例如，當您有多個面板可視化相同的資料時，此策略可以大幅減少正在進行的查詢數量。

與其他面板共用資料來源查詢的步驟

  1. 建立儀表板。如需詳細資訊，請參閱 建立儀表板。

  2. 加入嵌板。如需詳細資訊，請參閱 新增面板。

  3. 將標題變更為Source panel。您將使用此面板做為其他面板的來源。定義將共用的一個或多個查詢。如果目前沒有可用的資料來源，則可以使用 Grafana 資料來源，該資料來源會傳回可用於測試的隨機時間序列。

  4. 新增第二個面板，然後在查詢編輯器中選取儀表板資料來源。

  5. 在「使用面板清單中的結果」中，選取您建立的第一個嵌板。

來源面板中定義的所有查詢現在都可供新面板使用。在來源面板中進行的查詢可與多個面板共用。

若要前往定義查詢的面板，請選擇該查詢。