查询和仪表盘
仪表盘和数据源定义属于 Ambari 元数据。指标样本保留在 VictoriaMetrics 中，浏览器只能通过受限的 Ambari 代理查询。
| 操作 | 所需权限 |
|---|---|
| 读取仪表盘/数据源和查询指标 | CLUSTER.VIEW_METRICS |
| 打开 Targets 路由 | HOST.VIEW_METRICS |
| 打开服务 Metrics 标签页 | SERVICE.VIEW_METRICS |
| 创建/更新/删除仪表盘 | CLUSTER.MANAGE_USER_PERSISTED_DATA |
| 创建/更新/删除/设为默认数据源 | AMBARI.MANAGE_SETTINGS |
Ambari Server 也会检查权限。菜单可见不代表有权修改数据源或仪表盘。
配置数据源
- 打开 Data sources，检查集群的数据源列表。
- 对于未启用 VMAUTH 身份验证的 Ambari 托管 VictoriaMetrics 安装，检查自动配置的默认数据源。
- 对于其他身份验证或路由拓扑，使用 Ambari Server 可访问的查询端点创建显式数据源。VMAGENT 摄取端点不是 VictoriaMetrics 查询端点。
- 通过数据源设置配置身份验证和 TLS，测试连接，启用数据源并选择所需的默认数据源。
- 返回 Explorer，在诊断仪表盘布局前验证近期查询。
数据源测试失败可能表示网络、身份验证、TLS、租户路由或 URL 无效。请修复错误报告的边界，不要全局禁用证书验证。
从 PromQL 开始
选择数据源和时间范围。以下示例使用 cluster1；请替换为实际集群标签。
up{cluster="cluster1",ambari_target="host"}
值为 1 表示该目标抓取成功。缺失序列与显式零值不同：除收集器健康状态外，还要检查目标发现和所选时间窗口。
ambari_agent_memory_available_bytes{cluster="cluster1",ambari_target="host"}
此 gauge 以字节报告可用内存。主机查询必须包含 ambari_target="host"，以免将同名组件指标误认为主机指标。
sum by (host) (
rate(ambari_agent_cpu_seconds_total{
cluster="cluster1",ambari_target="host",cpu="total",mode!="idle"
}[2m])
)
此示例汇总聚合 CPU 序列的非空闲 CPU 时间速率，不是预先标准化的利用率百分比。对于现成的容量/利用率面板，请使用内置 Linux 仪表盘。
使用和自定义仪表盘
内置目录包含十一个仪表盘：Linux Fleet Overview、Linux Host Detail、HDFS、NameNode、DataNode、HBase Master、HBase RegionServer、HiveServer2、NodeManager、ResourceManager 和 ResourceManager 主机指标。
打开仪表盘，选择其数据源/时间范围，并使用变量缩小显示的主机或组件。此基线配置的服务标签页覆盖 HDFS、YARN、HBase 和 Hive；其他服务需要自己的遥测和仪表盘集成。
编辑器支持面板配置、变量、克隆、JSON 导入/导出、保存和图表共享。将导出的仪表盘定义置于版本控制中，但不要嵌入数据源密钥。克隆的仪表盘可以以内置查询为起点，同时保留集群和单位约定。
Ambari 将保留的 cluster 变量绑定到当前应用集群，并将 __rate_interval 计算为四个查询步长或 120 秒中的较大者。这些保留变量不是用户可编辑的仪表盘筛选器。计数器使用 rate 或 increase；gauge 直接查询。
此运行截图来自固定版本的三节点监控验证记录。图中数值仅代表该开发环境，不是容量规划基准。
API 示例
以下查询端点相对于 Ambari 通常的 /api/v1 基础路径。使用数据源列表中的数据源 ID，而不是仪表盘 ID。保持查询 URL 编码：
export DATASOURCE_ID=1
curl --fail --get --user "$AMBARI_USER" \
--data-urlencode 'query=up{cluster="cluster1",ambari_target="host"}' \
"$AMBARI_URL/api/v1/metrics/$DATASOURCE_ID/api/v1/query"
范围查询使用对应的 query_range 端点以及 query、start、end 和 step。使用此示例前，请按部署指南中的说明设置环境变量。
限制和恢复
查询边界将查询限制为 65,536 个字符，将范围查询限制为 11,000 个点，将批处理限制为 64 个查询，将数据源响应限制为 16 MiB，并将配置的请求超时限制为最多 60 秒。重试超大请求前，缩短时间窗口或增大查询步长。
面板请求会在上下文变化时取消，失败面板不会清除其他成功面板。区分空数据、权限错误、不可用数据源、过期目标和无效表达式。更改仪表盘前先检查 Targets，再检查 Explorer。
图表共享属于 Ambari 授权和集群绑定模型，不承诺匿名公开访问。请使用预期接收者的权限测试共享。
实现参考
请参阅固定版本的 Metrics API 客户端、监控页面和Linux 收集器。