在此页面上
了解 Junos 遥测接口上的 OpenConfig 和 gRPC
从 Junos OS 16.1R3 版开始，您可以使用一组远程过程调用 （RPC） 接口来配置 Junos 遥测接口，并使用 gRPC 框架流式传输遥测数据。OpenConfig 支持使用供应商中立的数据模型来配置和管理多供应商网络。gRPC 是一个开源框架，可提供安全可靠的数据传输。
OpenConfig for Junos OS 和 gRPC 仅在 MX 系列上的 MPC 和从 Junos OS 16.1R3 版开始的 PTX 系列路由器上受支持。
从 Junos OS 17.2R1 版开始，QFX10000 交换机、QFX5200 交换机和 PTX1000 路由器也支持 OpenConfig 和 gRPC。
从 Junos OS 17.3R1 版开始，PTX3000路由器、QFX5110 交换机以及 EX4600 和 EX9200 交换机上的路由控制和板卡 （RCB） 支持 Junos 遥测接口。 MX80 和 MX104 路由器不支持 OpenConfig 和 gRPC。
从 Junos OS 17.4R1 版开始，支持 MX2008 路由器。
从 Junos OS 18.3R1 版开始，MX 系列和 PTX 系列路由器的 gRPC 支持ON_CHANGE LLDP 遥测传感器信息的流式传输。
从 Junos OS 18.3R1 版开始，还支持 QFX5120-48Y 和 EX4650 交换机。
从 Junos OS 18.4R1 版开始，还支持 EX4600 交换机。
从 Junos OS 18.4R1 版开始，还支持 MX480、MX960、MX2010、MX2020、MX2008 和 MX-ELM 路由器。
从 Junos OS 19.1R1 版开始，还支持使用 MS-MIC 和 MS-MPC 运行的 MX 系列路由器、QFX10002 交换机和 PTX10002 路由器。
从 Junos OS 演化版 19.1R1 开始，支持 OpenConfig （OC） 和 Junos 遥测接口 （JTI）。gRPC API 和面向客户的 CLI 与 Junos OS 相同。按照 Junos OS 的标准配置，网络代理 （NA） 和 OC 软件包是 Junos OS 演化版映像的一部分。
从 Junos OS 演化版 19.1R1 开始，还支持 PTX10003 路由器上的数据包转发引擎传感器。
从 Junos OS 19.2R1 版开始，SRX4100、SRX4200、SRX4600、SRX5400、SRX5600、SRX5800 和 vSRX 虚拟防火墙系列服务网关。
从 Junos OS 19.2R1 版开始，MX960、MX2008、MX2010 和 MX2020 路由器、PTX1000 和 PTX10000 路由器以及 QFX5200 交换机支持用于流式数据包转发引擎统计信息的 gNMI 服务。
从 Junos OS 19.2R1 版开始，QFX5110、QFX5120、QFX5200 和 QFX5210 交换机支持用于流统计信息的 gNMI 服务。
从 Junos OS 版本 19.3R1 开始，托管 MPC10E-10C-MRATE 和 MPC10E-15C-MRATE 线卡的 MX 系列路由器支持用于导出统计信息的 gRPC 服务。
从 Junos OS 演化版 19.3R1 开始，QFX5220-128C 和 QFX5220-32CD 交换机支持用于导出统计信息的 gRPC 服务。
从 Junos 19.4R1 版开始，EX4300-MP 交换机支持用于流式传输数据包转发引擎和路由引擎统计信息的 gRPC 服务。
Junos OS 演进版 19.4R1 记录了 JTI 对 PTX10008 路由器的支持，但不支持。
从 Junos 版本 20.R1 开始，MX2010 和 MX2020 路由器上的 MX2K-MPC11E 线卡支持用于数据包转发引擎统计信息的流式遥测传感器的 gNMI 服务。
从 Junos OS 20.1R1 版开始，JTI 支持 gRPC 服务版本 v1.18.0。此版本包括针对 gRPC 的重要增强功能。在早期的 Junos OS 版本中，JTI 支持 gRPC 版本 v1.3.0。
从 Junos OS 演进版 20.2R1 开始，PTX10001 路由器都支持用于流式处理 NDP 统计信息的 gRPC 服务。
从 Junos OS 20.2R1 版开始，EX2300、EX2300-MP 和 EX3400 交换机支持用于流式传输数据包转发引擎和路由引擎统计信息的 gRPC 服务。
从 Junos OS 20.2R1 版开始，支持容器化路由协议进程 （cRPD） 的任何平台系列都支持用于流式传输 BGP 路由信息库 （RIB） 和 BGP 对等统计信息的 gRPC 服务。cRPD 是瞻博网络的路由协议进程 （rpd），与 Junos OS 分离，打包为 Docker 容器，可在基于 Linux 的环境中运行。
从 Junos OS 20.2R1 版开始，MX960、MX2008、MX2010、MX2020、PTX1000、PTX5000、PTX10000 路由器以及 QFX5100 和 QFX5200 交换机支持使用 gRPC 服务和 gNMI 服务ON_CHANGE BGP 对等统计信息导出。
从 Junos OS 20.2R1 版开始，EX2300、EX3400、EX4300、EX4600 和 EX9200 交换机支持使用 gRPC 服务流式传输 BGP 全局、对等和 perr 组统计信息。
从 Junos OS 20.2R1 版开始，SRX5400、SRX5600 和 SRX5800 服务网关支持使用 gRPC 服务和 gNMI 服务通过数据包转发引擎传感器进行流式传输收入接口统计信息，并通过路由引擎传感器进行伪接口统计信息。
从 Junos OS 20.2R1 版开始，SRX5400、SRX5600 和 SRX5800 服务网关支持使用 gRPC 服务和 gNMI 服务通过数据包转发引擎传感器进行流式传输收入接口统计信息，并通过路由引擎传感器进行伪接口统计信息。
从 Junos OS 20.2R1 版传感器开始，MX480、MX960、MX10003、MX2010 和 MX2020 路由器支持流式待机路由引擎统计信息。
从 Junos OS 20.2R1 版开始，QFX5100、QFX5110、QFX5120、QFX5200、QFX10002-60C、QFX10002、QFX10008 和 QFX10016 交换机支持使用 gRPC 服务流式传输 EVPN 统计信息的传感器。
网络代理软件
如果您的瞻博网络设备运行的是具有升级版 FreeBSD 的 Junos OS 版本，则使用 gRPC 实现 OpenConfig for Junos 遥测接口需要下载并安装名为 Network Agent 的软件包。对于所有其他版本的 Junos OS，网络代理功能嵌入在软件中。Network Agent 充当 gRPC 服务器并终止 OpenConfig RPC 接口。它还负责根据 OpenConfig 规范流式传输遥测数据。若要查看遥测的 OpenConfig 规范，请参阅 OpenConfig 遥测规范。有关 OpenConfig for Junos OS 的更多信息，请参阅 OpenConfig 用户指南。
网络代理组件还支持基于服务器的安全套接字层 （SSL） 身份验证。不支持基于客户端的 SSL 身份验证。您必须在瞻博网络设备上安装 SSL 证书。
有关安装网络代理包的信息，请参阅 安装网络代理包。
使用 OpenConfig for Junos OS 启用 Junos 遥测接口
OpenConfig for Junos OS 指定用于启用 Junos 遥测接口的 RPC 模型。您必须在瞻博网络设备上下载并安装 OpenConfig for Junos OS 软件包。该软件包还包括所需的 YANG 型号。
您可以在给定操作系统的 GitHub 存储库中找到所有 YANG 数据模型 ，并在单个下载包中发布。软件包和存储库包括本机配置、状态和 RPC 数据模型以及该操作系统支持的 OpenConfig 和 IETF 数据模型。您还可以从瞻博网络下载站点访问 YANG 数据模型。
使用 Web 浏览器，导航到瞻博网络网页上的“所有 Junos 平台”软件下载 URL： https://www.juniper.net/support/downloads/。 从 “网络管理 ”选项卡中，向下滚动以选择 OpenConfig。选择 软件 选项卡。选择适当版本的 OpenConfig 模块。有两个版本可用，一个适用于运行 Junos OS 并升级版 FreeBSD 的设备，另一个适用于运行所有其他 Junos OS 版本的设备。有关更多信息，请参阅 安装 OpenConfig 软件包 和 了解 Junos OS YANG 模块。
网络代理包安装的编程接口 OpenConfigTelemetry 定义遥测 gRPC 服务。 telemetrySubscribe RPC 指定以下订阅参数：
-
OpenConfig 路径，用于标识要流式传输遥测数据的系统资源，例如：
/interfaces/interface/state/counters/ -
向收集器服务器报告数据并将其流式传输到收集器的时间间隔（以毫秒为单位），例如：
sample_frequency = 4000
telemetrySubscribe流式处理服务器或收集器使用 RPC 请求指定路径上数据的内联订阅。然后，设备应通过与订阅请求相同的连接将遥测数据发送回。
GitHub 资源
GitHub 是一个用于版本控制和协作的代码托管平台。它使您可以和其他人从任何地方共同处理项目。瞻博网络是 OpenConfig 社区的成员，该社区使用 GitHub 开发遥测代码和存储文档。通过在 GitHub 上创建帐户，为瞻博网络遥测开发做出贡献。
| 遥测资源 |
描述 |
|---|---|
| 瞻博网络遥测模型、增强和偏差。 |
|
| 瞻博网络协议缓冲区文件，按 Junos OS 版本组织。 |
|
| Juniper gNMI 协议缓冲区文件，由 Junos OS 版本组织。 |
|
| 杨模特 | 从 Junos OS 演化版 23.4R1 开始，给定操作系统和版本的所有 YANG 数据模型都位于单个下载包和 GitHub 存储库中。软件包和存储库包括本机配置、状态和 RPC 数据模型，以及该操作系统支持的 OpenConfig 和 Internet 工程任务组 （IETF） 数据模型。 |
使用 gRPC 流式传输数据
根据 OpenConfig 规范，流数据仅支持基于 gRPC 的传输。由网络代理包安装的 gRPC 服务器从运行客户端的管理系统终止 gRPC 会话。RPC 调用会触发 Junos OS 传感器的创建，这些传感器可以定期流式传输数据或报告事件，然后由网络代理将这些事件汇集到相应的 gRPC 通道上。
从 Junos OS 18.2R1 版开始，当外部流服务器或收集器在运行 Junos OS 的设备上配置传感器以通过 gRPC 导出数据时，传感器配置将提交到 junos-analytics 临时配置数据库的实例，并且可以使用操作命令查看 show ephemeral-configuration instance junos-analytics 配置。在早期版本中，传感器配置提交到临时配置数据库的默认实例。
作为更新的一部分导出的瞻博网络遥测标头现在导出为扩展标头。GnmiJuniperTelemetryHeader.proto 用于解码运行 Junos OS 19.3 版或更低版本的瞻博网络设备的更新，GnmiperTelemetryHeaderExtension.proto 用于运行 Junos OS 19.4 或更高版本的设备。
有关为支持 Junos 遥测接口而实现的 RPC 的列表和说明，请参阅 表 2 。
RPC 名称 |
描述 |
|---|---|
|
为指定的 OpenConfig 路径列表指定遥测参数和流数据。 |
|
检索通过 创建的 |
|
取消订阅通过 创建的 |
通过 gRPC 流式传输的数据在协议缓冲区 （gpb） 消息中的 OpenConfig 键/值对中进行格式化。在这种通用格式中，键是对应于被监控设备的 OpenConfig 架构中系统资源路径的字符串。这些值对应于标识系统资源（如接口计数器）的操作状态和资源状态的整数或字符串。
从 Junos OS 18.2R1 版开始，除了基于 OpenConfig 的路由引擎 （RE） 传感器的键/值对之外，通过 gRPC 流式传输的数据还可以格式化为 protobuf。这些传感器是对数据包转发引擎 （PFE） 传感器的补充。
下面显示了通用键/值格式：
message KeyValue {
string key = 1 [(telemetry_options).is_key = true];
uint64 int_value = 2;
string str_value = 3;
string prefix_str = 4;
}
message TelemetryStream {
// router name or export IP address
required string system_id = 1 [(telemetry_options).is_key = true];
// line card / RE (slot number)
optional uint32 component_id = 2 [(telemetry_options).is_key = true];
// PFE (if applicable)
optional uint32 sub_component_id = 3 [(telemetry_options).is_key = true];
// timestamp (common to all entries in the kv array)
optional uint64 timestamp = 4 [(telemetry_options).is_timestamp = true];
// key / value pairs
repeated KeyValue kv;
}
以下示例说明如何表示接口的一组计数器：
key = “/interfaces/counters/rx-bytes”, int_value = 1000 key = “/interfaces/counters/tx-bytes”, int_value = 2000 key = “/interfaces/counters/rx-packets”, int_value = 10 key = “/interfaces/counters/rx-bytes” , int_value = 20 key = “/interfaces/counters/oper-state”, str_value = “up”
网络代理软件包提供了一个映射表，用于将字段名称映射到 OpenConfig 密钥字符串。
导出数据包转发引擎流量传感器数据
从 Junos OS 17.4R1 版开始，您可以通过 MX 系列和 PTX 系列路由器的 Junos 遥测接口导出数据包转发引擎流量统计信息。支持 UDP 和 gRPC。
此传感器跟踪数据包转发引擎统计信息计数器的报告，并提供对数据包转发引擎错误和丢弃统计信息的可见性。传感器的资源名称为 /junos/system/linecard/packet/usage/。OpenConfig 路径报告特定于 CPU、NPU 和中心芯片 （CC） 的数据。支持以下路径：
/components/component[name='FPCid:NPUid']/properties/property[name='counter']/state/value，其中 FPC 是指灵活的 PIC 集中器，NPU 是指网络处理单元（数据包转发引擎）。示例资源路径是/components/component[name='FPC0:NPU3']/properties/property[name='ts-output-pps']/state/value的Hardware Discards: Data Error计数器。hwds-data-error/components/component[name='FPCid:CCid’]/properties/property[name='counter’]/state/value，其中 FPC 是指柔性 PIC 集中器，CC 是指中心芯片。示例资源路径是/components/component[name='FPC0:CC1']/properties/property[name='lpbk-packets’']/state/valuelpbk-packets其中特定于 FPC0（中心芯片 1）的计数Forward packets。/components/component[name='FPCid’]/properties/property[name='counter’]/state/value，其中 FPC 是指柔性 PIC 集中器。示例资源路径是/components/component[name='FPC0']/properties/property[name='lts-input-packets’']/state/valuelts-input-packets其中 是 CPU 计数器Local packets input。
若要将传感器预配为通过 gRPC 导出数据，请使用 telemetrySubcribe RPC 指定遥测参数。对于通过 UDP 进行流式传输，所有参数都在层次结构级别进行 [edit services analytics] 配置。
以下是命令或show pfe statistics traffic detail命令中show pfe statistics traffic输出字段的计数器映射（仅在 MX 系列路由器上受支持）。
CPU stats: (FPCX:CPUY)
Packet Forwarding Engine local traffic statistics:
Local packets input : 2
Local packets output : 1
Software input control plane drops : 0
Software input high drops : 0
Software input medium drops : 0
Software input low drops : 0
Software output drops : 0
Hardware input drops : 0
Counter
lts-input-packets Local packets input
lts-output-packets Local packets output
lts-sw-input-control-drops Software input control plane drops
lts-sw-input-high-drops Software input high drops
lts-sw-input-medium-drops Software input medium drops
lts-sw-input-low-drops Software input low drops
lts-sw-output-low-drops Software output drops
NPU stats: (FPCX:CCY)
Input packets: 1169 0 pps
Output packets: 0 0 pps
Fabric Input : 277235149 16078 pps
Fabric Output : 277235149 16079 pps
Counter
ts-input-packets Input packets
ts-input-packets-pps Input packets in pps
ts-output-packets Output packets
ts-output-packets-pps Output packets in pps
ts-fabric-input-packets Fabric Input
ts-fabric-input-packets-pps Fabric Input in pps
ts-fabric-output-packets Fabric Output
ts-fabric-output-packets-pps Fabric Output in pps
Packet Forwarding Engine loopback statistics:
Forward packets : 0 0 pps
Forward bytes : 0 0 bps
Drop packets : 0 0 pps
Drop bytes : 0 0 bps
Counter
lpbk-packets Forward packets
lpbk-packets-pps Forward packets pps
lpbk-packets-byte Forward bytes
lpbk-packets-bps Forward bytes bps
lpbk-drop-packets Drop packets
lpbk-drop-packets Drop packets pps
lpbk-drop-packets Drop bytes
lpbk-drop-packets Drop bytes bps
Lu chips stats: FPCx:NPUY
Counter
lts-hw-input-drops
hwds-normal Hardware discards normal discard
hwds-fabric Hardware discards fabric drops
hwds-info-cell Hardware discards info cell drops
hwds-timeout Hardware discards timeour
hwds-truncated-key Hardware discards truncated key
hwds-bits-to-test Hardware discards bits to test
hwds-stack-underflow Hardware discards stack underflow
hwds-stack-overflow Hardware discards stack overflow
hwds-data-error Hardware discards data error
hwds-extended Hardware discards extended discard
hwds-invalid-iif Hardware discards invalid interface
hwds-input-checksum Hardware discards input checksum
hwds-output-mtu
hwds-inet-bad-route
hwds-inet6-bad-route
hwds-filter-discard
hwds-dlu-not-routable
为 MX 系列路由器上基于 AFT 的线卡传输遥测数据
从 Junos OS 20.4R1 版开始，为支持抽象转发表 （AFT）（如 MPC10E 或 MPC11E 线卡）的模块化端口集中器 （MPC） 线卡（如 MPC10E 或 MPC11E 线卡）实现了用于遥测的前缀和密钥交付的新串联。与其他线卡上的语法相比，OpenConfig 路径的拆分方式不同。
下面的输出说明了前缀和密钥传递方面的更改。
Example jtimon output for a port on non-AFT LC key: __prefix__ str_value: /junos/firewall[name='CORERO-MITIGATE-xe-1/0/0.4051-i']/state/ key: counter[name='Corero-Allowed-xe-1/0/0.4051-i']/packets uint_value: 2935220 <<RESULT>> path: /junos/firewall[name='CORERO-MITIGATE-xe-1/0/0.4051-i']/state/counter[name='Corero-Allowed-xe-1/0/0.4051-i']/packets uint_value: 2935220 Example jtimon output for a port on an AFT LC key: __prefix__ str_value: /junos/firewall[name='CORERO-MITIGATE-et-2/0/0.114-i']/state/counter[name='Corero-Allowed-et-2/0/0.114-i']/ key: packets uint_value: 29191907 <<RESULT>> path: /junos/firewall[name='CORERO-MITIGATE-et-2/0/0.114-i']/state/counter[name='Corero-Allowed-et-2/0/0.114-i']/packets uint_value: 29191907
通过 gNMI 启用“变化时”传感器支持
自 Junos OS 16.1 版起，我们开始支持 OpenConfig 操作状态和计数器的定期流传输，可将遥测数据从瞻博网络设备导出到外部收集器。虽然在收集所有需要的信息和创建基线“快照”方面很有用，但对于时间紧迫的任务来说，定期流式传输的用处不大。在这种情况下，您可以为外部收集器配置ON_CHANGE流，以便仅在操作状态遇到状态更改时接收信息。
为了支持ON_CHANGE流，实施了一项称为 gRPC 网络管理接口 （gNMI） 的新规范，用于修改和检索网络元素中的配置。此外，gNMI 规范还可用于生成和控制从网元到数据收集系统的遥测流。使用新的 gNMI 规范，一个 gRPC 服务定义可以在网络元素上提供用于配置和遥测的单个实现，以及通过遥测和配置 RPC 与设备交互的单个 NMS 元素。
Junos 文件包 （junos-telemetry-interface） 包含 gnmi.proto 文件和 GnmiJuniperTelemetryHeader.proto 瞻博网络扩展，用于支持 gNMI。
有关支持此功能的 RPC 的信息，请参阅 gNMI Proto 文件版本 0.4.0（支持的版本）和发布的规范
https://github.com/openconfig/reference/blob/primary/rpc/gnmi/gnmi-specification.md
https://github.com/openconfig/gnmi/blob/primary/proto/gnmi/gnmi.proto
gNMI 服务下的遥测 RPC subscribe 支持ON_CHANGE流式处理。RPC subscribe 允许客户端请求目标向其发送数据树中特定路径的值。值可以流式传输 （STREAM）、在长期通道上一次性发送 （POLL） 或作为检索一次性发送 （ONCE）。
如果订阅采样频率为 0 的顶级容器，则会根据事件流式传输具有ON_CHANGE支持的叶子。其他叶子将不会流式传输。
为了允许设备决定哪些节点将作为ON_CHANGE进行流式传输以及哪些节点将进行采样，收集器必须使用 sample_interval 订阅 TARGET_DEFINED。
通过 gNMI 启用“TARGET_DEFINED”订阅模式
从 Junos OS 版本 20.2R1 开始，MX5、MX10、MX40、MX80、MX104、MX150、MX204、MX240、MX480、MX960、MX2008、MX2010、MX2020、MX10003、MX10008 和 MX10016 路由器上的 JTI 支持TARGET_DEFINED gRPC 网络管理接口 （gNMI） 服务的订阅模式。
使用 gNMI 订阅，外部收集器规定了应如何传输传感器数据：
流模式定期以指定的时间间隔从 DUT 流式传输传感器数据。
ON_CHANGE模式仅在数据值更改时从 DUT 发送传感器数据的更新。
新支持的TARGET_DEFINED模式（子模式 0）指示 DUT 选择相关模式（流或 ON_CHANGE），将传感器数据的每个元件（叶）传送到外部收集器。当子模式为 0 的传感器订阅从外部收集器发送到 DUT 时，DUT 会做出响应，激活传感器订阅，以便定期流式传输不包含任何ON_CHANGE更新。但是，只要发生符合条件的ON_CHANGE事件，DUT 就会通知收集器。
订阅将默认为 30 秒的定期流式处理频率，除非收集器在订阅请求中另行指定。
下面的 Java 脚本对象通知 （JSON） 文件显示了一个示例 gNMI 订阅。TARGET_DEFINED模式设置为资源 submode=0 （传感器）路径 /interfaces/interface[name='lo0']/state。
$ cat gnmi.json
{
"dut_list":[
{
"port":50051,
"rpc":["sub_request"],
"sub_request":{
"subscription":[
{
"path":"/interfaces/interface[name='lo0']/state",
"submode":0,
"sample_interval":30
}
],
"mode":0,
"encoding":2
}
}
]
$ python ./gnmi_subscribe_client_sample.py -c ./gnmi.json -d 10.53.32.102 -l client.log
Junos 文件包 （junos-telemetry-interface） 包含 gnmi.proto 文件和 GnmiJuniperTelemetryHeader.proto 瞻博网络扩展，用于支持 gNMI。
有关详细信息，请参阅此处的 gNMI 规范和 gNMI 协议文件：
通过 gNMI 启用“INITIAL_SYNC”订阅模式
从 Junos OS 版本 20.2R1 开始，支持 MX960、MX2008、MX2010、MX2020、PTX1000、PTX5000 路由器、PTX10000系列路由器以及 QFX5100 和 QFX5200 交换机上使用 gNMI 服务的数据包转发引擎传感器INITIAL_SYNC统计信息。
从 Junos OS 演化版 20.4R1 开始，支持在 QFX5130-32CD 交换机上使用 gNMI 服务来自数据包转发引擎传感器的INITIAL_SYNC统计信息。
当外部收集器发送具有 INITIAL_SYNC （gnmi-submode 2） 的传感器的订阅请求时，主机会将该资源路径下所有支持的目标叶（字段）至少发送到具有当前值的收集器一次。这很有价值，因为：
收集器可以完整查看设备上该传感器路径的每个字段的当前状态。
在看到下一个事件之前，收集器至少接收一次事件驱动的数据 （ON_CHANGE）。这样，收集器就可以在下一个事件发生之前知道数据状态。
发送数据包转发引擎传感器，其中包含通常不会显示在流数据中的零计数器值（零抑制），以确保收集器知道每个线卡（也称为源）中的所有字段。
INITIAL_SYNC子模式要求至少将一个副本发送到收集器;但是，发送多个是可以接受的。
订阅将默认为 30 秒的定期流式处理频率，除非收集器在订阅请求中另行指定。
下面的 Java 脚本对象通知 （JSON） 文件显示了一个示例 gNMI 订阅。INITIAL_SYNC模式是使用资源 gnmi_submode 2 （传感器）路径 /interfaces/ 设置的。设置为 gnmi_mode 0。协议编码设置为 2 GBP。
{
"influx": {
"server": "server1",
"port": 8086,
"dbname": "gD40",
"measurement": "OC",
"user": "influx",
"password": "influxdb",
"recreate": true
},
"gnmi": {
"mode": 0, <---- STREAM
"encoding": 2, <--- PROTO encoding
"prefix": "/x/y/z"
},
"host": "10.10.130.73",
"port": 10162,
"user": "user1",
"password": "password1",
"cid": "cid-1jk",
"paths":[
{
"path": "/interfaces/",
"Freq": 10000000000,
"gnmi_submode": 2 <---- SAMPLE
}
]
}
Junos 文件包 （junos-telemetry-interface） 包含 gnmi.proto 文件和 GnmiJuniperTelemetryHeader.proto 瞻博网络扩展，用于支持 gNMI。
有关详细信息，请参阅此处的 gNMI 规范和 gNMI 协议文件：
gNMI 遥测规范 gNMI 协议定义
https://github.com/openconfig/reference/blob/primary/rpc/gnmi/gnmi-specification.md#35152-stream-subscriptions
https://github.com/openconfig/gnmi/blob/primary/proto/gnmi/gnmi.proto
启用遥测传感器信息的客户端流和双向流
从 Junos OS 18.1R1 版开始，通过远程过程调用 （gRPC） 和 JTI 对 OpenConfig 的支持得到了扩展，以支持 MX 系列和 PTX 系列路由器上的遥测传感器信息的客户端流和双向流。
API 基于 OpenConfig 的 Protobuf 规范在 Junos 中实现。这些 API 使用 gRPC 作为传输机制，在 Junos 路由器上执行配置、操作状态检索和遥测。
使用客户端流式处理，客户端向服务器发送请求流，而不是单个请求。服务器通常会发回包含状态详细信息和可选尾随元数据的单个响应。通过双向流式处理，客户端和服务器都会发送请求和响应流。客户端通过调用 RPC 启动操作，服务器接收客户端元数据、方法名称和截止时间。服务器可以选择发回其初始元数据或等待客户端开始发送请求。客户端和服务器可以按任意顺序读取和写入。流完全独立运行。
Junos 设备可以通过 API （RPC） 原型进行管理：
RPC 功能 （AbilityRequest）
返回值（功能响应）。允许客户端检索目标支持的功能集。
rpc Get （GetRequest）
返回 （获取响应）。从目标检索数据的快照。
rpc set （SetRequest）
返回 （设置响应）。允许客户端修改目标上数据的状态。
rpc 订阅（流订阅请求）
返回（流订阅响应）。允许客户端请求目标为其发送数据树中特定路径的值。这些值可以流式传输 （STREAM） 或在长期通道 （POLL） 上一次性发送，也可以作为一次性检索发送 （ONCE）。如果订阅了采样频率为 0 的顶级容器，则会根据事件流式传输具有ON_CHANGE支持的叶。其他叶子将不会流式传输。
瞻博网络扩展工具包 （JET） 支持为用户提供有关连接到 JSD 的客户端状态的洞察。JET 对 gRPC 的支持包括将可连接到 JSD 的最大客户端数从 8 个扩展到 30 个（默认值仍为 5）。要指定最大连接数，请在 [edit system services extension-service request-response grpc] 层次结构级别包含max-connections语句。
要提供有关连接到 JSD 的客户机状态的信息，请发出增强 show extension-service client information 的命令并包括 clients 或 servers 选项。该 clients 选项显示请求-响应客户端信息。该 servers 选项显示请求-响应服务器信息。
为 SR-TE 策略（BGP 或静态）启用遥测传感器信息流
从 Junos OS 18.3R1 版开始，OpenConfig 通过 gRPC 和 JTI 支持 MX 系列和 PTX 系列，无论给定分段路由流量工程 （SR-TE） 策略的活动路由（BGP 或静态）如何，都可以通过同一传感器提供连续的统计信息流。
Junos OS 演化版 21.4R1EVO 为 PTX10001-36MR、PTX10004、PTX10008 和 PTX10016 路由器提供支持。
此功能支持入口路由器上的 BGP [DRAFT-SRTE] 和静态配置的 SR-TE 策略。
若要将传感器预配为通过 gRPC 流式处理导出数据，请使用遥测订阅 RPC 指定遥测参数。包括用于导出这些统计信息的资源路径 /mpls/signaling-protocols/segment-routing/ 。
除了配置传感器之外，还必须通过 Junos OS 启用统计信息收集。为此，请在 [edit protocols source-packet-routing telemetry] 层次结构级别包含statistics配置语句。或者，您可以通过包含no-transit或no-ingress参数来限制统计信息。
有关配置传感器的说明，请参阅 在 Junos 中配置 NETCONF 代理遥测传感器 。
有关资源路径的详细信息，请参阅 gRPC 和 gNMI 传感器（Junos 遥测接口）指南 。
支持 LSP 统计信息
您可以配置 LSP 统计信息传感器 / junos/services/label-switched-path/usage/ 来监控每个 MPLS 的 LSP 统计信息。遥测数据从 Junos 设备流式传输，并通过 gRPC 以可配置的时间间隔通过 JTI 导出到外部收集器，而无需轮询。
Junos OS 15.1F6 版中对此功能的初始支持仅在订阅 / junos/services/label-switched-path/usage/ 时支持入口 LSP。通过在 Junos OS 17.4R1 版中添加了旁路支持，此订阅现在可以将入口 LSP 和旁路 LSP 统计信息流式传输到收集器。
流式传输的统计信息类似于操作模式命令 show mpls lsp bypass statistics 和 show mpls lsp ingress statistics显示的输出。
对于旁路 LSP，将导出以下内容：
绕过源自受保护 LSP 的入口路由器的 LSP。
绕过源自受保护 LSP 的中转路由器的 LSP。
绕过 LSP，保护传输 LSP 以及本地发起的 LSP。
当旁路 LSP 处于活动状态时，流量将同时导出到旁路 LSP 和入口（受保护）LSP 上。
若要设置传感器以通过 gRPC 导出数据，请使用遥测订阅 RPC 指定遥测参数。通过 gRPC 流式传输遥测数据还需要 OpenConfig for Junos OS 模块。默认情况下，OpenConfig 和 Network Agent 软件包都捆绑到 Junos OS 映像中。
有关配置 UDP（本机）传感器的信息，请参阅配置 Junos 遥测接口传感器（CLI 过程）。
有关按平台划分的 LSP 传感器支持级别，请参见 表 3 。
平台 |
入口 LSP、UDP 功能介绍 |
入口 LSP、gRPC 流 功能介绍 |
旁路 LSP 功能介绍 |
|---|---|---|---|
ACX6360 |
|
|
Junos 19.2R1 源自中转节点的 RSVP 旁路 LSP |
MX80/MX104 |
Junos OS 15.1F6 版 Junos OS 16.1R3 版 Junos OS 17.2R1 版 |
|
Junos OS 17.4R1 版 Junos OS 版本 17.2X75D50+ |
带 MPC 的 MX 系列 |
Junos OS 15.1F6 版 |
Junos OS 16.1R4 版 Junos OS 17.2R1 版 |
Junos OS 17.4R1 版 Junos OS 版本 17.2X75D50+ |
使用 FPC3 PTX5000 |
|
Junos OS 18.2R1 版 |
Junos OS 17.4R1 版 |
与 FPC3 PTX3000 |
Junos OS 15.1F6 版 Junos OS 16.1R3 版 Junos OS 17.2R1 版 |
Junos OS 16.1R4 版 Junos OS 17.2R1 版 Junos OS 18.2R1 版 |
Junos OS 17.4R1 版 Junos OS 版本 17.2X75D50+ |
带 FPC1/2 的 PTX 系列 |
Junos OS 15.1F6 版 Junos OS 16.1R3 版 Junos OS 17.2R1 版 |
Junos OS 16.1R4 版 Junos OS 17.2R1 版 Junos OS 18.2R1 版 |
Junos OS 17.4R1 版 Junos OS 版本 17.2X75D50+ |
PTX1000 |
Junos OS 16.1R3 版 |
Junos OS 16.1R4 版 Junos OS 17.2R1 版 |
Junos OS 17.4R1 版 Junos OS 版本 17.2X75D50+ |
PTX10000 |
Junos OS 17.3R1 版 |
Junos OS 17.3R1 版 |
Junos OS 17.4R1 版 Junos OS 版本 17.2X75D50+ |
PTX10001-20C |
|
Junos OS 19.1R1 版 源自中转节点的 RSVP 旁路 LSP |
|
PTX10002 |
Junos OS 19.1R1 版 |
Junos OS 19.1R1 版 |
|
VMX |
Junos OS 17.3R1 版 |
Junos OS 17.3R1 版 |
Junos OS 17.4R1 版 Junos OS 版本 17.2X75D50+ |
MX150： |
Junos OS 17.4R1 版 |
Junos OS 17.4R1 版 |
|
EX4600 |
Junos OS 18.4R1 版 |
|
|
EX4650 |
Junos OS 18.3R1 版 |
Junos OS 18.3R1 版 |
|
EX9200 |
Junos OS 17.3R1 版 |
|
|
QFX10000 |
|
|
|
QFX5200 |
Junos OS 17.2R1 版 |
Junos OS 17.2R1 版 |
|
QFX10002 |
Junos OS 19.1R1 版 |
Junos OS 19.1R1 版 |
|
QFX5100 |
Junos OS 18.2R1 版 |
Junos OS 18.2R1 版 |
|
QFX5110 |
Junos OS 18.2R1 版 |
Junos OS 18.2R1 版 |
|
QFX5120-48Y |
Junos OS 18.3R1 版 |
Junos OS 18.3R1 版 |
|
QFX5200 |
Junos OS 18.2R1 版 |
Junos OS 18.2R1 版 |
|
路由引擎传感器的消息结束通知
从 Junos OS 21.2R1 版开始，我们为所有 JTI 路由引擎传感器引入了消息结束 （EoM） 布尔标志。该标志通知收集器特定传感器路径的电流包装已完成。换行是传感器路径下所有叶的完整键值数据转储。
EoM 标志还使收集器能够检测包装何时结束，而无需比较收集器从数据包接收的流创建时间戳值。比较时间戳值在时间上成本高昂，并且会延迟数据聚合。
要将此功能与 gRPC 网络管理接口 （gNMI） 传输或远程过程调用 （gRPC） 配合使用，请从 瞻博网络 下载站点上的相关分支检索 protobuf 文件：
- GnmiJuniperTelemetryHeaderExtension.proto （gNMI）
- agent.proto （for gRPC）
例如：https://github.com/Juniper/telemetry/blob/master/20.3/20.3R1/protos/GnmiJuniperTelemetryHeaderExtension.proto。
在收集器上下载并安装新的 protobuf 文件后，EoM 字段将存在于收到的数据包中。
动态隧道统计支持
从 Junos OS 17.4R1 版开始，您可以通过 JTI 使用本机 （UDP） 或 OpenConfig 遥测传感器将数据包转发引擎动态隧道的计数器统计信息导出到外部收集器。
这些统计数据用于以可扩展且高效的方式报告各种网元性能指标，从而提供数据包转发引擎错误和丢弃的可见性。
所有导出的数据都包含指示计数器上次重置时间的时间戳，以允许收集器确定是否以及何时发生重置事件;例如，如果 P acket 转发引擎硬件重新启动。
导出的统计信息类似于操作模式命令 show nhdb hw dynamic-ip-tunnels的输出。
若要通过 gRPC 预配统计信息导出，请使用遥测订阅 RPC 创建订阅并指定遥测参数。在订阅中包含资源路径 /junos/services/ip-tunnel[name='tunnel-name']/ usage/counters[name='counter-name']/ 。
通过 gRPC 流式传输遥测数据还需要 OpenConfig for Junos OS 模块。从 Junos OS 18.3R1 版开始，默认情况下，OpenConfig 和 Network Agent 软件包捆绑到 Junos OS 映像中。这两个软件包都支持 JTI。
要配置通过 UDP 导出统计信息，请将传感器包含在 [edit services analytics] 层次结构级别的传感器/junos/services/ip-tunnel/usage/（Junos 遥测接口）配置语句中。UDP 传感器的所有参数都配置在该层次结构级别。MX80 和 MX104 路由器仅支持 UDP 流。它们不支持 gRPC。
FPC 和光学器件支持
从 Junos OS 19.2R1 版开始，JTI 支持使用远程过程调用 （gRPC） 流式传输 MX 系列的灵活 PIC 集中器 （FPC） 和光学统计信息。gRPC 是用于配置和检索状态信息的协议。支持包括添加一个新进程（SensorD守护程序）来导出遥测数据，以便与OpenConfig模型中称为AFT平台的AFTTelementry和LibTelemetry库集成。
支持以下基本资源路径：
/junos/system/linecard/environment/
/junos/system/linecard/optics/
若要将传感器预配为通过 gRPC 导出数据，请使用遥测订阅 RPC 指定遥测参数。通过 gRPC 流式传输遥测数据还需要 OpenConfig for Junos OS 模块。从 Junos OS 18.3R1 版开始，默认情况下，OpenConfig 和 Network Agent 软件包捆绑到 Junos OS 映像中。这两个软件包都支持 JTI。
JTI 对 MX 系列上 Junos Fusion 的宽带边缘统计支持
从 Junos OS 19.2R1 版开始，当为宽带网络网关 （BNG） 和 Junos Fusion 配置 MX 路由器且订阅者通过 Junos Fusion 卫星设备连接时，将启用基于订阅者的遥测流。可以使用远程过程调用 （gRPC） 将宽带边缘 （BBE） 遥测统计信息导出到外部收集器。
您可以流式传输所有 BBE 资源路径，但以下路径除外：
/junos/system/subscriber-management/access-network/ancp
/junos/system/subscriber-management/client-protocols/l2tp
/junos/system/subscriber-management/infra/network/l2tp/
若要流式传输 BBE 统计信息，请在 gRPC 订阅中包含以 / junos/system/subscriber-management/ 开头的资源路径。
若要将传感器预配为通过 gRPC 导出数据，请使用 telemetrySubscribe RPC 指定遥测参数。
CPU 和 NPU 传感器支持采用 MPC10E-15C-MRATE 线卡的 MX 系列路由器
Junos OS 19.3R1 版支持带有 MPC10E-10C-MRATE 和 MPC10E-15C-MRATE 线卡的 MX 系列路由器上的 CPU 和网络处理单元 （NPU） 传感器。JTI 允许使用 gRPC 服务以可配置的时间间隔将这些传感器的统计信息导出到外部收集器。
与先前 Junos 版本中 CPU 和 NPU 传感器的 Junos 内核实现不同，此功能使用 OpenConfig AFT 模型。因此，与 Junos 内核输出相比，资源路径和键值 （kv） 对输出存在差异。
使用以下资源路径导出统计信息：
/junos/system/linecard/cpu/memory/
/junos/system/linecard/npu/memory/
/junos/system/linecard/npu/utilization/
若要将传感器预配为通过 gRPC 服务导出数据，请使用 telemetrySubcribe RPC 指定遥测参数。通过 gRPC 流式传输遥测数据还需要 OpenConfig for Junos OS 模块。从 Junos OS 18.3R1 版开始，默认情况下，OpenConfig 和 Network Agent 软件包捆绑到 Junos OS 映像中。这两个软件包都支持 JTI。
有关 gRPC 资源路径的详细信息，请参阅 gRPC 传感器指南（Junos 遥测接口）。
接口快速传感器
JTI 支持接口快速传感器，以用户可配置的速率导出接口操作 UP 和 DOWN 状态。该传感器利用物理接口传感器的统计信息，提供更快、更频繁的操作状态统计信息。仅收集和报告来自灵活 PIC 集中器 （FPC） 的物理接口操作状态。不报告来自路由引擎接口的统计信息。
可以使用传感器通过 UDP（本机）导出或通过 gRPC 服务导出统计信息。
对于任一导出方法，请包含以下资源路径：
/junos/system/linecard/intf-exp/
Junos OS 18.1R1 版支持 PTX1000、PTX3000、PTX5000 和 PTX10000 路由器的接口快速传感器。
Junos OS 19.3R1 版支持 MX960、MX2010 和 MX2020 路由器的接口快速传感器。
有关 gRPC 资源路径的详细信息，请参阅 gRPC 和 gNMI 传感器（Junos 遥测接口）指南。
用户的备用路由引擎传感器
JTI 支持使用 gRPC 服务的流式备用路由引擎统计信息。除非另有说明，否则单机箱和虚拟机箱都支持此功能。使用此功能可以更好地跟踪备用路由引擎上运行的软件组件的状态。通过以下传感器导出到外部收集器的统计信息（主要在订阅者管理下）可提供系统运行状况和复原状态的更完整视图：
机箱角色（备份或主）传感器 / junos/system/subscriber-management/chassis 和 / junos/system/subscriber-management/chassis[chassis-index=chassis-index] （用于为 MX 系列虚拟机箱指定索引）
路由引擎状态和 GRES 通知传感器 /junos/system/subscriber-management/chassis/routing-engines/routing-engine 和 /junos/system/subscriber-management/chassis/routing-engines/routing-engine[re-index=RoutingEngineIndex]（用于指定特定路由引擎的索引号）
订户管理进程传感器 / junos/system/subscriber-management/chassis/routing-engines/process-status/subscriber-management-processes/subscriber-management-process 和 / junos/system/subscriber-management/chassis/routing-engines/process-status/subscriber-management-processes/subscriber-management-process[pid=ProcessIdentifier] （为特定进程指定 PID）
每个路由引擎 服务器或中继传感器的 DHCP 绑定统计信息 /junos/system/subscriber-management/chassis/routing-engines/routing-engine/dhcp-bindings/dhcp-element[dhcp-type-name=RelayOrServer/v4] 和 /junos/system/subscriber-management/chassis/routing-engines/routing-engine/dhcp-bindings/dhcp-element[dhcp-type-name=RelayOrServer/v6]
虚拟机箱端口计数器传感器 /junos/system/subscriber-management/chassis/virtual-chassis-ports /virtual-chassis-port 和 / junos/system/subscriber-management/chassis/virtual-chassis-ports/virtual-chassis-port[vcp-interface-name=vcp-interface-port-string]（用于指定接口名称）。此资源路径仅在虚拟机箱上受支持。
Junos OS 20.2R1 版支持 MX480、MX960、MX10003、MX2010 和 MX2020 路由器的备用路由引擎传感器。
有关 gRPC 和 gNMI 资源路径的详细信息，请参阅 gRPC 和 gNMI 传感器指南（Junos 遥测接口）。
面向订户的直径应用协议和直径对等传感器
JTI 支持直径应用协议网络访问服务器应用程序 （NASREQ）、策略和计费规则功能 （PCRF） 以及在线计费系统 （OCS） 的用户流统计信息。还有新的直径对等传感器，为每个直径应用程序在 MX 路由器和对等方之间交换的消息提供响应时间测量。使用 JTI 和瞻博网络 AAA 模型导出统计信息，该模型涵盖了使用 gRPC、gNMI 或瞻博网络专有 RPC 或 UDP 进行遥测导出。
要流式传输直径应用程序统计信息，请包括以下资源路径：
有关 NASREQ 统计信息， /junos/system/subscriber-management/aaa/diameter/clients/nasreq
有关 PCRF 统计信息， /junos/system/subscriber-management/aaa/diameter/clients/gx
有关 OCS 统计信息，/ junos/system/subscriber-management/aaa/diameter/clients/gy
要流式传输直径应用程序的响应时间测量值，请在订阅中包含资源路径或使用配置语句：sensor
对于 NASREQ 测量， /junos/system/subscriber-management/aaa/diameter/peers/peer[peer_address=''peer-address]/nasreq/response-time
对于 PCRF 测量，/ junos/system/subscriber-management/aaa/diameter/peers/peer[peer_address=''peer-address]/gx/response-time
对于 OCS 测量， /junos/system/subscriber-management/aaa/diameter/peers/peer[peer_address=''peer-address]/gy/response-time
要为 MX 系列路由器启用这些统计信息以进行本机 （UDP） 导出，请在 [edit services analytics] 层次结构级别包含sensors语句。
若要设置传感器以通过 gNMI 导出数据，请使用 gnmi.proto 中定义的订阅 RPC 指定请求参数。
若要将传感器预配为通过 gRPC 导出数据，请使用 telemetrySubscribe RPC 指定遥测参数。通过 gRPC 流式传输遥测数据还需要 OpenConfig for Junos OS 模块。从 Junos OS 18.3R1 版开始，默认情况下，OpenConfig 和 Network Agent 软件包捆绑到 Junos OS 映像中。这两个软件包都支持 JTI。
Junos OS 19.3R1 版支持 MX5、MX10、MX40、MX150、MX204、MX240、MX480、MX960、MX2008、MX2010、MX2020、MX10003、MX10008 和 MX100016 路由器的直径应用协议传感器。
有关 gRPC 和 gNMI 资源路径的详细信息，请参阅 gRPC 和 gNMI 传感器指南（Junos 遥测接口）。
接口突发监控
Junos OS 演化版 19.3R1 支持在 Junos 遥测接口 （JTI） 上进行接口突发监控，以监控 QFX5220-128C 和 QFX5220-32CD 交换机上的物理接口突发。使用接口突发监控来帮助解决问题、做出决策并根据需要调整资源。
采样在导出间隔（窗口）期间以毫秒粒度完成。导出间隔在传感器中配置，其中包含来自收集器的订阅。安装传感器后，数据包转发引擎中将启动一个计时器，以 30-100ms 的间隔轮询硬件。第一批出口中的费率将为 0。
峰值字节是在采样间隔内看到的字节数的平均值。对于持续时间小于采样间隔的突发，峰值字节将在间隔内取平均值。导出的统计信息还包括检测到峰值字节的时间以及方向（发送或接收）。在所有样本的导出间隔期间检测到的最大字节速率被视为突发。如果间隔内有多个字节数相同的突发，则第一次发生的突发被视为最大突发，该突发的时间戳被视为突发时间戳。
将导出所有 UP 物理接口的数据。不支持聚合接口。
通过使用远程过程调用 （gRPC） 服务的订阅中包含传感器 / junos/system/linecard/bmon-sw/ ，可以将接口突发统计信息从瞻博网络设备导出到外部收集器。此传感器仅支持一个收集器。
若要将传感器预配为通过 gRPC 服务导出数据，请使用 telemetrySubcribe RPC 指定遥测参数。通过 gRPC 流式传输遥测数据还需要 OpenConfig for Junos OS 模块。
此功能不会检测微爆发。
收发器诊断
Junos OS 19.4R1 版支持收发式诊断传感器，使用 MX960、MX2010、MX2020、PTX1000、PTX5000 和 PTX10000 系列路由器上使用 JTI 和 gRPC 服务或 gNMI 服务进行ON_CHANGE和流统计信息。使用收发器诊断来帮助排除故障、做出决策并根据需要调整资源。
此功能支持 OpenConfig 收发器模型 openconfig-platform-transceiver.yang 0.5.0。
使用 gRPC 或 gNMI 订阅中的基本资源路径 / components/component/transceiver/ 将统计信息从瞻博网络设备导出到外部收集器。
ON_CHANGE不支持温度、输入功率和输出功率以及激光偏置电流等连续变化的场。
物理以太网接口传感器
Junos OS 19.4R1 版支持在 MX960、MX2020、PTX1000 和PTX5000路由器上使用 JTI 和 gRPC 服务或 gNMI 服务进行ON_CHANGE和流统计信息的物理以太网接口统计信息。
此功能支持 OpenConfig 模型 openconfig-if-ethernet.yang （物理接口级别） 版本 2.6.2（无配置）。
使用 gRPC 或 gNMI 订阅中的基本资源路径 / interfaces/interface/ethernet/state/ 将统计信息从瞻博网络设备导出到外部收集器。
VLAN 传感器
Junos OS 19.4R1 版支持在 EX4650 和 QFX5120 交换机上使用 JTI 和 gRPC 服务的ON_CHANGE流式传输 VLAN 统计信息。
此功能支持 OpenConfig 模型 openconfig-vlan.yang 配置版本 1.0.2。
使用 gRPC 订阅中的基本资源路径 / vlans/ 将统计信息从瞻博网络设备导出到外部收集器。
可在订阅中使用的其他终结点包括：
/vlans/vlan/state/name
/vlans/vlan/state/vlan-id
/vlans/vlan/members/
/vlans/vlan/members/member/interface-ref/state/interface/
/vlans/vlan/members/member/interface-ref/state/interface/switched-vlan/state/interface-mode
/vlans/vlan/members/member/interface-ref/state/interface/switched-vlan/state/native-vlan
/vlans/vlan/members/member/interface-ref/state/interface/switched-vlan/state/access-vlan
/vlans/vlan/members/member/interface-ref/state/interface/switched-vlan/state/trunk-vlan
/vlans/vlan/members/member/interface-ref/state/interface/vlan/state/vlan-id
更改历史记录表
功能支持由您使用的平台和版本决定。使用功能资源管理器确定您的平台是否支持某个 功能 。
junos-analytics 临时配置数据库的实例，并且可以使用操作命令查看
show ephemeral-configuration instance junos-analytics 配置。