外部监控

VergeOS 不支持 SNMP。本指南涵盖外部监控的受支持路径——Prometheus Exporter（ioMetrics）、REST API 和 IPMI——以及像 SolarWinds 这类以 SNMP 为先的工具。

概述

本页面介绍如何将 VergeOS 与外部监控和可观测性平台集成。VergeOS 采用 API 优先设计，并通过三种受支持的方式公开平台运行状况、性能和硬件传感器数据。

不支持 SNMP

VergeOS 不包含 SNMP 代理、MIB 或陷阱机制。SNMP 设计于 20 世纪 80 年代末，用于管理路由器、交换机和打印机等硬件网络设备，而非现代软件定义平台。VergeOS 采用 API 优先设计：SNMP 代理可公开的每项指标和资源，均已通过 REST API 和 Prometheus Exporter 提供；它们通过标准 HTTP 提供更丰富的结构化数据。这与更广泛的行业转变一致：Microsoft 已在 Windows Server 2012 中弃用 SNMP 服务，云原生和虚拟机监控程序平台则已标准化采用 Prometheus 暴露格式。如果您的旧版监控工具需要 SNMP，请参阅 SNMP 优先工具下文了解可用的解决方法。

支持的监控方式

方式

适用场景

适用对象

Prometheus Exporter (ioMetrics)

vSAN、集群和节点指标

大多数环境推荐的起点

REST API

自定义采集器，轮询任意资源

特定工具集成、脚本化检查

IPMI

每节点硬件运行状况和传感器

VergeOS 外部的硬件级监控

Prometheus Exporter (ioMetrics)

该 VergeOS Prometheus Exporter (ioMetrics) 是平台级指标的推荐方式。它从 VergeOS 收集 vSAN 层级、集群和节点级指标，并以标准 Prometheus 格式公开，可供 Prometheus、Grafana、VictoriaMetrics 或任何兼容 Prometheus 的系统抓取。

为何这是推荐方式

第一方 — 由 verge-io 组织维护
基于标准 — 任何兼容 Prometheus 的监控工具均可使用该输出

请参阅 Prometheus Exporter (ioMetrics) 页面，了解产品内概述、公开的指标以及开源项目链接。

REST API

VergeOS REST API 公开了 UI 可以读取的每个资源，因此它适合用于自定义采集器、脚本化运行状况检查，或与不支持 Prometheus 的工具集成。

身份验证

外部监控采集器会长期运行，应使用 API 密钥而非会话令牌进行身份验证。API 密钥按用户创建，可限定 IP 范围并设置过期时间。请参阅 API 密钥了解设置，以及参阅 API 指南了解完整的受支持身份验证方法列表。

Swagger 文档

完整且与版本准确对应的 API 参考资料可在 VergeOS 内部获取：

单击 用户图标 ，位于 VergeOS UI 的右上角。
选择系统.
选择 API 文档.

Swagger 页面列出每个表和操作，并提供可直接针对系统运行的示例。

从何开始

有关 HTTP 约定、筛选、排序和示例请求的背景信息，请参阅知识库中的 API 指南。

何时使用 REST API 进行监控

监控工具支持 HTTP 轮询，但不支持 Prometheus
Prometheus Exporter 未公开某个特定指标或资源
需要自定义采集器以与内部可观测性平台集成

IPMI

对于 每节点硬件运行状况和传感器数据 — 温度、风扇转速、电压、功耗、硬件错误 — VergeOS 会直接公开节点的 IPMI 接口。

导航至 基础架构 > 节点 ，可从顶部菜单进入。
双击所需节点以打开节点仪表板。
在 IPMI 子菜单下，单击连接以在新标签页中打开 IPMI Web 界面，或单击测试以验证从 VergeOS 发起的连接。

仅限硬件

IPMI 公开主机节点的 物理硬件 状态，而非 VergeOS 应用层指标。大多数监控平台已经包含 IPMI 采集器，可直接轮询节点 BMC，并与上述 Prometheus Exporter 和 REST API 方式并行使用。

有关配置已存储的 IPMI 凭据和测试连接，请参阅 IPMI 页面。

SNMP 优先工具

诸如 SolarWinds, LogicMonitor, PRTG和 Nagios 等工具通常配置为通过 SNMP 监控基础架构。VergeOS 没有针对这些工具的现成集成，因为没有可供它们连接的 SNMP 代理。

首先检查原生 Prometheus 支持

这些平台中的部分现在可原生接收 Prometheus 指标 — LogicMonitor （OpenMetrics 数据源）和 SolarWinds Observability （Prometheus 集成）。如果您的平台属于其中之一，请将其指向 Prometheus Exporter ，并跳过本节其余内容。以下两个选项适用于不支持 Prometheus 的工具，其中包括本地部署的 SolarWinds Platform / SAM, PRTG和 Nagios.