使用 Azure 活頁簿查詢 Prometheus 計量
使用 Azure 活頁簿建立由適用於 Prometheus 的 Azure 監視器受管理服務提供技術支援的儀表板。 本文介紹 Azure 監視器工作區的活頁簿,並說明如何使用 Azure 活頁簿和 Prometheus 查詢語言 (PromQL) 來查詢 Prometheus 計量。
您也可以從 Azure 監視器工作區中的計量瀏覽器使用 PromQL 查詢 Prometheus 計量。 如需詳細資訊,請參閱搭配 PromQL 的 Azure 監視器計量瀏覽器 (預覽) (部分機器翻譯)。
必要條件
若要從 Azure 監視器工作區查詢 Prometheus 計量,您需要下列項目:
- Azure 監視器工作區。 若要建立 Azure 監視器工作區,請參閱建立 Azure 監視器工作區。
- 您的 Azure 監視器工作區必須從 AKS 叢集或虛擬機器擴展集收集 Prometheus 計量。 如需詳細資訊,請將 Prometheus 計量從虛擬機器、擴展集或 Kubernetes 叢集傳送至 Azure 監視器工作區。
- 使用者必須被指派可在 Azure 監視器工作區上執行 microsoft.monitor/accounts/read 作業的角色。
Prometheus 總管活頁簿
Azure 監視器工作區包含探索活頁簿,可查詢您的 Prometheus 計量。
- 在 Azure 監視器工作區概觀頁面中,選取 [Prometheus 總管]
- 或 [活頁簿] 功能表項目,然後在 Azure 監視器工作區資源庫中,選取 [Prometheus 總管] 活頁簿圖格。
活頁簿具有下列輸入選項:
- 時間範圍。 選取要包含在查詢中的時段。 選取 [自訂] 以設定開始和結束時間。
- PromQL。 輸入 PromQL 查詢以擷取您的資料。 如需 PromQL 的詳細資訊,請參閱查詢 Prometheus。
- [圖形]、[方格] 和 [維度] 索引標籤。 在查詢輸出的圖形、表格式和維度檢視之間切換。
建立 Prometheus 活頁簿
活頁簿支援許多視覺效果和 Azure 整合。 如需 Azure 活頁簿的詳細資訊,請參閱建立 Azure 活頁簿。
從您的 Azure 監視器工作區中,選取 [活頁簿]。
選取新增。
Azure 活頁簿會使用資料來源來設定其呈現資料的來源範圍。 若要查詢 Prometheus 計量,請選取 [資料來源] 下拉式清單,然後選擇 [Prometheus]。
從 [Azure 監視器工作區] 下拉式清單中,選取您的工作區。
從 [Prometheus 查詢類型] 下拉式清單中選取您的查詢類型。
在 [Prometheus 查詢] 欄位中撰寫 PromQL 查詢。
選取 [執行查詢] 按鈕。
選取區段底部的 [完成編輯],並儲存您的工作
疑難排解
如果您收到訊息,指出「您目前沒有任何擷取至此 Azure 監視器工作區的 Prometheus 資料」,請:
- 確認您已在 Azure 監視器工作區的 [受監視的叢集] 刀鋒視窗中開啟計量收集。
如果您的活頁簿查詢未傳回資料,並傳回訊息「您沒有查詢存取權」:
- 檢查您是否有足夠的權限可在 Azure 監視器工作區中執行透過存取控制 (IAM) 指派的 microsoft.monitor/accounts/read。
- 確認您的網路設定是否支援查詢存取。 您可能需要透過私人端點來啟用私人存取,或需變更設定以允許公用存取。
- 如果您在瀏覽器中啟用了廣告封鎖,您可能需要暫停或停用活頁簿並加以重新整理,才能檢視資料。
常見問題集
本節提供常見問題的答案。
我遺漏所有或部分計量。 如何進行疑難排解?
您可以使用這裡的疑難排解指南,從受控代理程式擷取 Prometheus 計量。
為什麼我遺漏的計量有兩個相同名稱但大小寫不同的標籤?
Azure 受控 Prometheus 是不區分大小寫的系統。 如果字串 (例如計量名稱、標籤名稱或標籤值) 與其他時間序列的區別只有字串的大小寫不同,則系統會將這些字串視為相同的時間序列。 如需詳細資訊,請參閱 Prometheus 計量概觀。
我發現計量資料有一些差距,為什麼會發生此狀況?
在節點更新期間,對於從我們的叢集層級收集器所收集的計量,計量資料可能會出現 1 分鐘到 2 分鐘的差距。 發生此差距是因為在正常更新程序中,執行資料的節點正在更新中。 此更新程序會影響整個叢集的目標,例如 kube-state-metrics 和指定的自訂應用程式目標。 手動或透過自動更新來更新您的叢集時,就會發生這種情況。 這是預期的行為,發生的原因是其執行所在的節點正在更新。 此行為不會影響任何建議的警示規則。