使用 Azure 活頁簿查詢 Prometheus 計量
使用 Azure 活頁簿建立由適用於 Prometheus 的 Azure 監視器受管理服務提供技術支援的儀表板。 本文介紹 Azure 監視器工作區的活頁簿，並說明如何使用 Azure 活頁簿和 Prometheus 查詢語言 (PromQL) 來查詢 Prometheus 計量。
必要條件
若要從 Azure 監視器工作區查詢 Prometheus 計量，您需要下列項目：
- Azure 監視器工作區。 若要建立 Azure 監視器工作區，請參閱建立 Azure 監視器工作區。
- 您的 Azure 監視器工作區必須從 AKS 叢集收集 Prometheus 計量。
- 使用者必須被指派可在 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 和指定的自訂應用程式目標。 手動或透過自動更新來更新您的叢集時，就會發生這種情況。 這是預期的行為，發生的原因是其執行所在的節點正在更新。 此行為不會影響任何建議的警示規則。