了解所收集数据的 Junos 遥测接口导出格式
Junos 遥测接口支持两种以协议缓冲区 （gpb） 格式导出数据的方法：
通过来自所谓的本机传感器的 UDP，将数据导出到靠近源的位置，例如线卡或网络处理单元 （NPU）。瞻博网络定义了开放且可扩展的数据模型。
通过路由引擎导出数据的 gRPC 远程过程调用 （gRPC）。数据模型由 OpenConfig 定义，它支持使用供应商中立的数据模型来配置和管理网络。OpenConfig for Junos OS 支持 YANG 数据模型。对于仅运行基于升级版 FreeBSD 内核的 Junos OS 版本的平台，您必须安装一个名为 Network Agent 的单独软件包，该软件包用作 gRPC 服务器并终止 RPC 接口。.对于所有其他版本的 Junos OS，网络代理功能嵌入在软件中。您还必须安装 OpenConfig for Junos OS 模块和 YANG 型号。
本节介绍使用 UDP 从本机传感器导出的数据的格式。数据被封装到 UDP 报头中，而 UDP 报头又封装在 IPv4 有效负载中。此 Junos 遥测接口模型基于分布式架构，通过该架构，配置的传感器生成的数据直接从数据平面导出，绕过控制平面，从而节省这些资源以执行其他必要功能。
Junos 遥测接口在 Junos OS 15.1F3 版中引入，适用于在 MPC1 到 MPC6E 上配置接口的 MX 系列路由器，以及在 FPC3 上配置接口的 PTX 系列路由器上引入。从 Junos OS 15.1F5 版开始，MX 系列路由器上的 MPC7E、MPC8E 和 MPC9E 也支持 Junos 遥测接口。
从 Junos OS 16.1R3 版开始，还支持 PTX 系列路由器上的 FPC1、FPC2 和双路由引擎。
从 Junos OS 17.2R1 版开始，还支持 QFX10000 和 QFX5200 交换机。在QFX5200交换机上，仅支持 gRPC 流式处理。
从 Junos OS 17.3R1 版开始，PTX3000路由器、QFX5110 交换机以及 EX4600 和 EX9200 交换机上的路由控制和板卡 （RCB） 支持 Junos 遥测接口。
从 Junos OS 17.4R1 版开始，支持 MX2008 路由器。
了解传感器数据封装格式
本机传感器使用 UDP 将数据导出到靠近源的位置。可以导出各种类型的遥测数据，例如物理接口统计信息、防火墙过滤器计数器统计信息或标签交换路径 （LSP） 统计信息。传感器在启用后立即开始发出数据。
传感器数据表示为单个结构化协议缓冲区消息，名为 TelemetryStream。如下所示的消息或 .proto 文件包含标识数据源的多个属性，例如线卡、数据包转发引擎或路由引擎。还包括已配置传感器的名称。有关如何配置传感器的详细信息，请参阅 配置 Junos 遥测接口传感器（CLI 过程） 有关支持的本机传感器的列表，请参阅 传感器。
还必须下载.proto 流服务器或收集器支持的所有传感器的文件。从 Web 浏览器中，导航到瞻博网络页面上的所有 Junos 平台软件下载 URL：https://www.juniper.net/support/downloads/。选择 Junos OS 平台的名称和版本号后，请转到“工具”部分并下载 Junos 遥测接口数据模型文件包。有关配置流服务器的详细信息，请参阅流服务器（Junos 遥测接口）。
协议缓冲区消息定义
以下是协议缓冲区定义语言中的消息定义 TelemetryStream 。它显示了几个可选的嵌套结构，如 EnterpriseSensors，它们携带私有定义的传感器数据。
//
// This file defines the top level message used for all Juniper
// Telemetry packets encoded to the protocol buffer format.
// The top level message is TelemetryStream.
//
import "google/protobuf/descriptor.proto";
extend google.protobuf.FieldOptions {
optional TelemetryFieldOptions telemetry_options = 1024;
}
message TelemetryFieldOptions {
optional bool is_key = 1;
optional bool is_timestamp = 2;
optional bool is_counter = 3;
optional bool is_gauge = 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];
// configured sensor name
optional string sensor_name = 4 [(telemetry_options).is_key = true];
// sequence number, monotonically increasesing for each
// system_id, component_id, sub_component_id + sensor_name.
optional uint32 sequence_number = 5;
// timestamp (milliseconds since 00:00:00 UTC 1/1/1970)
optional uint64 timestamp = 6 [(telemetry_options).is_timestamp = true];
// major version
optional uint32 version_major = 7;
// minor version
optional uint32 version_minor = 8;
optional IETFSensors ietf = 100;
optional EnterpriseSensors enterprise = 101;
}
message IETFSensors {
extensions 1 to max;
}
message EnterpriseSensors {
extensions 1 to max;
}
extend EnterpriseSensors {
// re-use IANA assigned numbers
optional JuniperNetworksSensors juniperNetworks = 2636;
}
message JuniperNetworksSensors {
extensions 1 to max;
}
该 TelemetryStream 消息还包括携带不同类型数据的可选嵌套结构。一种结构承载企业，即私有定义的数据。各个公司（如瞻博网络）定义和维护企业传感器生成的属性。每家公司都被分配一个唯一的属性标识符。当前的约定是为每个属性使用 IANA 分配的企业 MIB 标识符。对于瞻博网络，此分配的标识符为 2636。
要验证是否已导出和接收特定消息类型，请检查 gpb 消息中的这些属性 TelemetryStream.enterprise.juniperNetworks 。
有关传感器数据收集的每个元素的说明，包括语义和相应的架构，请参阅 表 1 。
元素类型 |
描述 |
|---|---|
计数器 |
单调递增的无符号整数。当它达到最大值时，它从零开始。 |
表 |
一个无符号的 32 位或 64 位整数，可以增加或减少值。此元素表示的数据的一个示例是特定资源的瞬时值，例如队列深度或温度。 |
率 |
基本指标（如计数器或仪表）变化的速率。对于此元素类型，将显式定义度量单位（例如每秒位数），以及收集速率的间隔。 |
平均 |
基本指标的几个样本的平均值。例如，平均队列深度数据元素将通过对 队列深度 的多个元素求平均值来计算。对于此元素类型，我们强烈建议定义用于计算平均值的测量值数量以及测量值之间的时间间隔。否则，应显式定义计算此平均值的方法。 |
峰值 |
基本指标的几个样本中的最大值。例如，峰值队列深度元素将通过比较 队列深度 的多个测量值并选择最大值来计算。对于此数据元素类型，我们强烈建议您定义用于计算峰值的测量次数以及测量之间的时间间隔。否则，请明确定义如何定义此峰值。您还必须知道此值是否永远不会被清除，从而表示所有时间的总体最大值。 |
每个数据元素类型还包括元素子集。例如，数据元素Counter和将包括 、 average和Gaugepeak度量的rate子集。
更改历史记录表
功能支持由您使用的平台和版本决定。使用功能资源管理器确定您的平台是否支持某个 功能 。