共用方式為


使用 Azure 活頁簿查詢 Prometheus 指標

使用 Azure 活頁簿建立由 Azure 監視器適用於 Prometheus 的受管理服務提供技術支援的儀表板。 本文介紹 Azure 監視器工作區的活頁簿,並示範如何使用 Azure 活頁簿和 Prometheus 查詢語言 (PromQL) 查詢 Prometheus 計量。

您也可以從 Azure 監視器工作區中的度量探索器使用 PromQL 查詢 Prometheus 指標。 如需詳細資訊,請參閱搭配 PromQL 的 Azure 監視器計量總管(預覽版)。

先決條件

若要從 Azure 監視器工作區查詢 Prometheus 計量,您需要下列項目:

Prometheus 總管活頁簿

Azure 監視器工作區包含探索活頁簿,可查詢您的 Prometheus 計量。

  1. 在 Azure 監視器工作區概觀頁面中,選取 [Prometheus 總管]

顯示 Azure 監視器工作區功能選取項目的螢幕快照。

  1. 或選取 [活頁簿] 功能表項目,然後在 Azure Monitor 工作區資源庫中,選擇 Prometheus Explorer 活頁簿圖格。

顯示 Azure 監視器工作區圖庫的螢幕擷取畫面。

活頁簿具有下列輸入選項:

  • 時間範圍。 選取您想要包含在查詢中的時段。 選取 [自定義 ] 以設定開始和結束時間。
  • PromQL。 輸入 PromQL 查詢以擷取您的數據。 如需 PromQL 的詳細資訊,請參閱 查詢 Prometheus
  • 圖形方格維度標籤。 在查詢輸出的圖形、表格式和維度檢視之間切換。

顯示 PromQL 瀏覽器的螢幕快照。

建立 Prometheus 活頁簿

活頁簿支援許多視覺效果和 Azure 整合。 如需 Azure 活頁簿的詳細資訊,請參閱 建立 Azure 活頁簿

  1. 從您的 Azure 監視器工作區中,選取 [活頁簿]

  2. 選取 [新增]。

  3. 在新活頁簿中,選取 [ 新增],然後從下拉式 清單中選取 [新增查詢 ]。

顯示空白工作區中 [新增內容] 下拉式清單的螢幕快照。

  1. Azure 活頁簿會使用 數據源 來設定其呈現的數據來源範圍。 若要查詢 Prometheus 計量,請選取 [數據源] 下拉式清單,然後選擇 [Prometheus ]。

  2. [Azure 監視器工作區] 下拉式清單中,選取您的工作區。

  3. Prometheus 查詢類型 下拉式清單中選取您的查詢類型。

  4. Prometheus 查詢字段中編寫 PromQL 查詢。

  5. 選取 [執行查詢] 按鈕。

  6. 選取區段底部的 [完成編輯 ],並儲存您的工作

顯示範例 PromQL 查詢的螢幕快照。

故障排除

如果您收到訊息,指出「您目前沒有任何擷取至此 Azure 監視器工作區的 Prometheus 資料」,請:

  • 確認您已在 Azure 監視器工作區的 [監控的叢集] 頁面中啟用度量收集。

如果您的活頁簿查詢未傳回數據,並傳回訊息「您沒有查詢存取權」:

  • 檢查您是否有足夠的許可權,才能在 Azure 監視器工作區中執行透過訪問控制 (IAM) 指派的 microsoft.monitor/accounts/read
  • 確認您的網路設定是否支持查詢存取。 您可能需要透過私人端點來啟用私人存取,或需變更設定以允許公用存取。
  • 如果您在瀏覽器中啟用了廣告攔截器,您可能需要暫時停止或停用並刷新活頁簿,才能檢視數據。

常見問題

本節提供常見問題的解答。

我遺漏所有或部分計量。 如何進行疑難排解?

您可以使用 疑難解答指南 ,從受控代理程式擷取 Prometheus 計量。

為什麼我缺少具有相同名稱但大小寫不同的兩個標籤的度量數據?

Azure 管理 Prometheus 系統是不區分大小寫的。 如果字串 (例如計量名稱、標籤名稱或標籤值) 與其他時間序列的區別只有字串的大小寫不同,則系統會將這些字串視為相同的時間序列。 如需詳細資訊,請參閱 Prometheus 計量概觀

我發現計量資料有一些差距,為什麼會發生此狀況?

在節點更新期間,對於從我們的叢集層級收集器所收集的計量,計量資料可能會出現 1 分鐘到 2 分鐘的差距。 在正常更新過程中,由於執行資料的節點正在進行更新,因此會出現此間隙。 此更新程序會影響整個叢集的目標,例如 kube-state-metrics 和指定的自訂應用程式目標。 手動或透過自動更新來更新您的叢集時,就會發生這種情況。 這是預期的行為,發生的原因是其執行所在的節點正在更新。 此行為不會影響任何建議的警示規則。

後續步驟