使用 gNMI 订阅遥测数据

gNMI 协议定义了 Subscribe 用于订阅遥测数据的 RPC。遥测收集器使用此 RPC 从网络设备请求更新状态和配置数据。

对新订阅的请求封装在包含一个或多个资源路径的消息中SubscribeRequest。订阅的路径与目标网络设备上的特定数据实例相关。请求可以包含基于 OpenConfig 或本机 Junos 架构的路径。

订阅请求还必须包括以下模式之一：

• ONCE - 一次性数据请求。

• POLL - 用于定期按需检索数据。

• STREAM - 根据指定的触发器流式传输数据的长期订阅。

模式中的 STREAM 订阅必须指定以下子模式之一：

• ON_CHANGE - 仅当数据项的值发生更改时，才会发送数据更新。

• SAMPLE - 根据订阅请求中指定的间隔期，每个采样间隔发送一次数据更新。默认采样间隔为 30 秒。

• TARGET_DEFINED - 接收订阅请求的网络设备基于每个叶确定数据的最佳传递类型。如果消息中指定的路径引用事件驱动的数据， ON_CHANGE 则可以创建订阅。对于表示计数器值 SAMPLE 的数据，可能会创建订阅。

  注意：

  TARGET_DEFINED配置路径的订阅请求仅被视为ON_CHANGE请求。

对于 ONCE和 ON_CHANGE SAMPLE 订阅，收集器可以请求包含订阅中路径的当前状态的初始更新。此更新（也称为初始同步）很有价值，因为：

• 收集器可以完整查看设备上该传感器路径的每个字段的当前状态。

• 在看到下一个事件之前，收集器至少接收一次事件驱动的数据 （ON_CHANGE）。这样，收集器就可以在下一个事件发生之前知道数据状态。

• 发送包含零计数器值的数据包转发引擎传感器，这些计数器值通常由于零抑制而不会出现在流数据中。这可确保收集器知道每个线卡中的所有字段。

目标设备通过消息 SubscribeResponse 响应订阅请求。如果订阅请求要求进行初始同步，则目标将发送数据，后跟标志设置为 sync_response true的响应消息。初始同步后，目标设备会根据订阅模式继续更新路径。

该 SubscribeRequest 消息包含一个名为 updates_only的标志。当此标志设置为 true时，目标设备不会发送初始同步，只会发送后续更新，如下所示：

• 对于 STREAM 处于模式的 SAMPLE 订阅，更新将在下一个采样间隔发送。

• 对于 STREAM 处于模式的 ON_CHANGE 订阅，更新将在下次值更改时发送。

• 对于ONCE订阅，仅SubscribeResponse发送sync_responsefalse设置为 的 ，并且关闭订阅。

• TARGET_DEFINED 订阅被视为 ON_CHANGE 配置路径，更新在下次值更改时发送。

和SubscribeRequestSubscribeResponse消息的内容在 gnmi.proto 文件中定义。有关订阅 RPC 和订阅模式的详细信息，请参阅 gNMI 规范，网址为：gNMI 规范：订阅遥测更新。

注意：

以下限制适用于配置路径：

• POLL 不支持订阅。

• 前缀路径不包括在更新消息中。

• 特定于瞻博网络的元数据操作（如 active/inactive、 insert before/after、 comment/annotate和 protect/unprotect）不支持 gNMI 响应。这些可能出现在消息中，但无效。

• include SubscribeRequest suppress_redundant、 heartbeat_level、 allow_aggregation和 qos中不支持的参数。

• 仅支持原型编码。

• 不支持邮件中的 SubscribeRequest 扩展名

• 仅在密钥级别支持筛选订阅路径。

• 和TARGET_DEFINED订阅不支持ON_CHANGE以下提交变体：

  commit at、 commit prepare/activate和批处理提交。

• 从

  edit dynamic以及edit private编辑或配置模式。

• 不会为状态容器发送更新消息。

• 对于标识符或密钥是唯一配置叶的订阅列表，可能没有更新消息。