查詢 - 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

查詢索引標籤包含下列元素：

  • 資料來源選擇器

  • 查詢選項

  • 查詢檢查器按鈕

  • 查詢編輯器清單

資料來源選擇器

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

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

  • TestDataDB – 產生隨機步行資料的內建資料來源。Grafana 資料來源適用於測試視覺化效果和執行中的實驗。

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

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

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

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

查詢選項

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

Amazon Managed Grafana 會設定以深灰色文字顯示的預設值。變更會以白色文字顯示。若要將欄位傳回預設設定，請從 欄位刪除白色文字。

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

  • 最大資料點 – 如果資料來源支援， 會設定傳回的每個序列的資料點數目上限。如果查詢傳回的資料點多於最大資料點設定，資料來源會合併它們 （透過將它們彙總在一起，以平均或最大或其他函數來減少傳回的點數）。

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

    使用串流資料時，滾動緩衝區會使用最大資料點值。（串流是資料的連續流程，緩衝是將串流分割為區塊的一種方式）。

  • 最小間隔 – 設定自動計算間隔的最小限制，通常是最小抓取間隔。如果資料點每 15 秒儲存一次，則不需要間隔低於該資料點。另一個使用案例是將其設定為高於抓取間隔的最小值，以取得更粗細且運作良好的查詢。

  • 間隔 – 您可以在依時間彙總或分組資料點時使用的時間範圍。

    Amazon Managed Grafana 會自動計算可在範本查詢中用作變數的適當間隔。變數以秒為單位：$__interval；或以毫秒為單位：$__interval_ms。它通常用於彙總函數，例如 sum或 average。例如，這是使用間隔變數的 Prometheus 查詢：rate(http_requests_total[$__interval])。

    此自動間隔是根據圖形的寬度計算。如果使用者大幅縮小，間隔會變大，導致更粗細的彙總。如果使用者放大，間隔會減少，導致更精細的彙總。

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

  • 相對時間 – 覆寫個別面板的相對時間範圍，導致它們與儀表板右上角儀表板時間選擇器中選取的時間範圍不同。這可讓您在相同的儀表板上顯示不同時段或天數的指標。

  • 時間轉移 – 提供另一種方法來覆寫個別面板的時間範圍。此函數僅適用於相對時間範圍，而且您可以調整時間範圍。

    例如，您可以將面板的時間範圍變更為早於儀表板時間挑選器 2 小時。如需詳細資訊，請參閱時間範圍控制項。

  • 快取逾時 – （只有在資料來源中可用時，才會顯示此欄位。) 如果您的時間序列存放區具有查詢快取，則覆寫預設快取逾時。它以秒為單位指定為數值。

查詢檢查器按鈕

您可以選擇查詢檢查器來開啟面板檢查器的查詢索引標籤。在查詢索引標籤上，您可以看到面板傳送的查詢請求和回應。

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

注意

您需要至少新增一個查詢，查詢檢查器才能傳回結果。

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

查詢編輯器清單

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

在面板之間共用查詢結果

使用 Amazon Managed Grafana，您可以將一個面板的查詢結果用於儀表板中的任何其他面板。跨面板共用查詢結果可減少對資料來源提出的查詢數量，這可以改善儀表板的效能。

儀表板資料來源可讓您選取儀表板中的面板，其中包含您要共用結果的查詢。Amazon Managed Grafana 不會為每個面板傳送單獨的查詢，而是傳送一個查詢，而其他面板會使用查詢結果來建構視覺化效果。

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

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

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

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

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

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

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

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

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