使用 Azure 活頁簿建立由 Azure 監視器適用於 Prometheus 的受管理服務提供技術支援的儀表板。 本文介紹 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 Monitor 工作區資源庫中,選擇 Prometheus Explorer 活頁簿圖格。
活頁簿具有下列輸入選項:
- 時間範圍。 選取您想要包含在查詢中的時段。 選取 [自定義 ] 以設定開始和結束時間。
- 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 和指定的自訂應用程式目標。 手動或透過自動更新來更新您的叢集時,就會發生這種情況。 這是預期的行為,發生的原因是其執行所在的節點正在更新。 此行為不會影響任何建議的警示規則。