通过使用 Azure 工作簿,创建由 Azure Monitor 托管服务为 Prometheus 提供支持的仪表板。 本文介绍 Azure Monitor 工作区的工作簿,并演示如何使用 Azure 工作簿和 Prometheus 查询语言(PromQL)查询 Prometheus 指标。
还可以使用 Azure Monitor 工作区中的指标资源管理器中的 PromQL 查询 Prometheus 指标。 有关详细信息,请参阅使用 PromQL 的 Azure Monitor 指标资源管理器(预览版)。
Prerequisites
若要从 Azure Monitor 工作区查询 Prometheus 指标,请执行以下作:
- 需要一个 Azure Monitor 工作区。 有关详细信息,请参阅 “创建 Azure Monitor 工作区”。
- Azure Monitor 工作区必须从 Azure Kubernetes 服务 (AKS) 群集或虚拟机规模集收集 Prometheus 指标。 有关详细信息,请参阅“将 Prometheus 指标从虚拟机、规模集或 Kubernetes 群集发送到 Azure Monitor 工作区”。
- 必须为用户分配一个可以在 Azure Monitor 工作区上执行
microsoft.monitor/accounts/read
操作的角色。
Prometheus 浏览器工作簿
Azure Monitor 工作区包括一个浏览工作簿,用于查询 Prometheus 指标。
在 Azure Monitor 工作区的 “概述 ”页上,选择 “Prometheus 资源管理器”。
在 “工作簿” 菜单项和 Azure Monitor 工作区库中,选择 “Prometheus 资源管理器 ”工作簿磁贴。
工作簿具有以下输入选项:
- 时间范围:选择要包含在查询中的时间段。 选择“自定义”以设置开始和结束时间。
- PromQL:输入 PromQL 查询以检索数据。 有关 PromQL 的详细信息,请参阅 查询 Prometheus。
- 图形、网格、维度:使用选项卡在查询输出的图形、表格视图和维度视图中切换。
创建 Prometheus 工作簿
工作簿支持许多可视化效果和 Azure 集成。 有关 Azure 工作簿的详细信息,请参阅 “创建 Azure 工作簿”。
从 Azure Monitor 工作区中选择工作簿。
Select New.
在新工作簿中,选择“ 添加”,然后从下拉列表中选择 “添加查询 ”。
Azure 工作簿使用 数据源 为它们提供的数据设置源范围。 若要查询 Prometheus 指标,请选择 “数据源 ”下拉列表,然后选择 “Prometheus ”。
从 Azure Monitor 工作区 下拉列表中,选择工作区。
从 Prometheus 查询类型 下拉列表中,选择查询类型。
在 Prometheus(预览版)查询字段中输入 PromQL 查询 。
选择“运行查询”。
选择 “完成编辑 ”并保存工作。
Troubleshooting
如果您收到“您当前没有任何 Prometheus 数据引入到此 Azure Monitor 工作区”的消息,则:
- 验证是否在 Azure Monitor 工作区的 “受监视群集 ”窗格中打开了指标集合。
如果工作簿查询未返回数据并返回消息“您没有查询访问权限”,则:
- 检查您是否拥有在 Azure Monitor 工作区中通过
microsoft.monitor/accounts/read
选项执行所需的足够权限。 - 确认 网络 设置是否支持查询访问。 可能需要通过专用终结点启用专用访问,或更改设置以允许公共访问。
- 检查是否在浏览器中启用了广告阻止程序。 如果这样做,可能需要暂停或禁用相关功能,然后刷新工作簿以查看数据。
常见问题
本部分提供常见问题的解答。
我缺少所有或部分指标。 如何进行故障排除?
使用 故障排除指南 了解如何从托管代理引入 Prometheus 指标。
为什么我缺少具有名称相同但大小写不同的两个标签的指标?
Azure 管理型 Prometheus 是一个不区分大小写的系统。 如果字符串(例如指标名称、标签名称或标签值)与另一个时序的区别仅在于字符串的大小写,则它会将这些字符串视为相同的时序。 有关详细信息,请参阅 Prometheus 指标概述。
我看到指标数据存在一些差距。 为什么会发生此行为?
在节点更新期间,对于从群集级别收集器收集的指标,可能会发现指标数据存在一分钟到两分钟的差距。 发生此差距的原因是运行数据的节点正在作为正常更新过程的一部分进行更新。 此更新过程影响整个群集范围内的目标,例如 kube-state-metrics 和指定的自定义应用程序目标。 当群集手动更新或通过自动更新时,将发生此过程。
此行为是预期的,不会影响我们推荐的任何警报规则。