13-Telemetry命令参考

01-gRPC命令

1 gRPC

1.1 gRPC通用配置命令

1.1.1 display grpc

display grpc命令用来显示gRPC的相关信息。

【命令】

display grpc [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

verbose：显示gRPC的详细信息。不指定该参数时，将显示gRPC的概要信息。

【举例】

# 显示gRPC的概要信息。

<Sysname> display grpc

gRPC status : Enabled

gRPC CPU usage max percent : 20

PKI domain : grpc

Current-time: 2020-05-20T04:12:48.119

------------Dial-in mode information------------

gRPC server port: 50052

gRPC server compression: None

Session idle-timeout: 10 minutes

Session count: 1

ID IP Address:Port UserName

1 192.1.11.254:53030 test

------------Dial-out mode information-----------

Sensor group count: 10

Sensor path count: 70

Destination group count: 5

Destination count: 4

Subscription count: 2

Connection ID: 1

IP address:Port: 192.1.1.254:11111

Encoding: JSON

Status: Connected

表1-1 display grpc命令显示信息描述表

字段	描述
gRPC status	gRPC功能状态： · Enabled：表示gRPC功能处于开启状态 · Disabled：表示gRPC功能处于关闭状态
gRPC CPU usage max percent	gRPC的CPU最大占用率，单位为百分比未配置grpc cpu-usage max-percent命令时，本字段不显示
PKI domain	设备和采集器建立gRPC连接时引用的PKI域未配置grpc pki domain命令时，本字段显示为“--”
Current-time	系统当前时间
Dial-in mode information	Dial-in模式相关信息
gRPC server port	gRPC服务使用的端口号
gRPC server compression	gRPC服务器使用的数据压缩方式： · GZIP：gzip压缩方式 · None：不压缩数据
Session idle-timeout	gRPC会话超时时间，单位为分钟
Session count	gRPC会话数量
ID	gRPC会话ID
IP Address:Port	客户端的IP地址和端口号
UserName	用户名
Dial-out mode information	Dial-out模式相关信息
Sensor group count	传感器组的数量
Sensor path count	采样路径的数量
Destination group count	目标组的数量
Destination count	采集器的数量
Subscription count	订阅的数量
Connection ID	设备与采集器建立的连接的ID
IP address:Port	采集器的IP地址和端口号
Domain name:Port	采集器的域名（以及第一个路由可达的IP地址，不存在该IP地址时显示为“--”）和端口号
Encoding	订阅报文的编码方式 · JSON：对上送数据使用JSON编码格式 · GPB：对上送数据使用GPB编码格式
Status	设备与采集器的连接通道状态，取值包括： · Init：通道正在初始化 · Idle：通道闲置 · Connecting：通道正在连接 · Connected：通道已连接 · Transient failure：通道暂时故障，正在尝试恢复 · Shutdown：通道因故障关闭

# 显示gRPC的详细信息。

<Sysname> display grpc verbose

gRPC status : Enabled

gRPC CPU usage max percent : 20

PKI domain : grpc

Current-time: 2020-05-20T04:12:44.346

------------Dial-in mode information------------

gRPC server port: 50052

gRPC server compression: None

Session idle-timeout: 10 minutes

Session count: 1

Session ID: 1

User name: test

Client IP address : 192.1.11.254:53030

Received RPCs : 39 Received erroneous RPCs : 6

Received subscription: 0 Sent notifications: 0

------------Dial-out mode information-----------

Sensor group count: 10

Sensor path count: 70

Destination group count: 5

Destination count: 4

Subscription count: 1

Subscription s

Subscription mode: non-gNMI

DSCP value: 0

Source-address or interface: Not configured

Telemetry data model: 2-layer

Encoding: GPB

Compression: None

TimeStamp: Common

Sensor group: s

Sampling interval: N/A

Sampling type Effective sampling interval Sensor path

...

destination-group: d

Start-time: 2020-05-20T03:38:05.833

IP:Port: 1.1.1.1:50051

VPN: N/A

Periodic sampling statistics:

Effective count: 272

Sent successfully: 0 Failed: 68

Event-triggered statistics:

Effective count: 0

Sent successfully: 0 Failed: 0

Queued packets/Queue size: 204/1000

Dropped: 0

Last error: Channel(Connecting)

...

表1-2 display grpc verbose命令显示信息描述表

字段	描述
gRPC status	gRPC功能状态： · Enabled：表示gRPC功能处于开启状态 · Disabled：表示gRPC功能处于关闭状态
gRPC CPU usage max percent	gRPC的CPU最大占用率，单位为百分比未配置grpc cpu-usage max-percent命令时，本字段不显示
PKI domain	设备和采集器建立gRPC连接时引用的PKI域未配置grpc pki domain命令时，本字段显示为“--”
Current-time	系统当前时间
Dial-in mode information	Dial-in模式相关信息
gRPC server port	gRPC服务使用的端口号
gRPC server compression	gRPC服务器使用的数据压缩方式： · GZIP：gzip压缩方式 · None：不压缩数据
Session idle-timeout	gRPC会话超时时间，单位为分钟
Session count	gRPC会话数量
Session ID	gRPC会话ID
User name	用户名
Login time	登录时间
Idle time	gRPC会话达到超时前的剩余空闲时间，0表示不超时
Client IP address	客户端的IP地址和端口号
Received RPCs	设备接收到的gRPC请求报文数量
Received erroneous RPCs	设备接收到的错误gRPC请求报文数量
Received subscription	设备接收到的gRPC订阅请求报文数量
Sent notifications	设备上报通知的数量
Dial-out mode information	Dial-out模式相关信息
Sensor group count	传感器组的数量
Sensor path count	采样路径的数量
Destination group count	目标组的数量
Destination count	采集器的数量
Subscription count	订阅的数量
Subscription	订阅的名称
Subscription mode	订阅类型，取值包括： · gNMI：gNMI模式的订阅 · non-gNMI ：普通订阅
Push mode	gNMI模式的订阅的采样数据推送模式，取值包括： · Condition-triggered：条件触发推送模式 · Periodic and Event-triggered：周期采样和事件触发采样推送模式
DSCP value	设备发送订阅报文的DSCP优先级
Source-address or interface	设备发送订阅报文的源地址或源接口取值为Not configured时表示未配置源地址和源接口
Telemetry data model	gRPC使用的Telemetry数据模型，取值包括： · 2-layer：二层Telemetry数据模型 · 3-layer：三层Telemetry数据模型
Encoding	订阅报文的编码方式 · JSON：对上送数据使用JSON编码格式 · GPB：对上送数据使用GPB编码格式
Compression	对订阅报文使用的数据压缩方式： · GZIP：gzip压缩方式 · None：不压缩数据
TimeStamp	订阅报文的JSON格式业务数据的打时间戳方式，取值包括： · Common：按订阅报文打时间戳 · Row：按行打时间戳
Sensor group	传感器组的名称
Sampling interval	数据采样和推送周期对于事件触发类型的采样路径，该字段的取值始终为0，表示设备不会周期进行数据采样
Sampling type	采样路径的类型，取值包括： · Event-triggered：由事件触发采样 · Periodic：按固定周期采样
Effective sampling interval	实际生效的数据采样和推送周期
Sensor path	采样路径
Destination-group	目标组的名称
Start-time	gRPC连接建立的时间
IP:Port	采集器（gRPC服务器）的IP地址和端口号
Domain name:Port	采集器的域名（以及第一个路由可达的IP地址）和端口号
VPN	采集器所属VPN实例的名称 N/A表示未指定VPN实例，采集器位于公网中
Periodic sampling statistics	周期采样的信息统计
Event-triggered statistics	事件触发采样的信息统计
Effective count	有效采集次数，不包括采集到空报文的次数
Sent successfully	发送成功的报文数量
Failed	发送失败的报文数量
Queued packets/Queue size	缓存待发送的报文数量/缓存队列大小
Dropped	因缓存队列满而丢弃的报文数量
Last error	最近一次的错误信息 · --：表示无错误信息 · VPN doesn’t exist：VPN不存在 · PKI failed：gRPC连接引用的PKI出错，例如其中的证书失效 · Channel (reason)：gRPC通道告警，reason取值包括： ¡ Init：通道正在初始化 ¡ Idle：通道闲置 ¡ Connecting：通道正在连接 ¡ Transient failure：通道暂时故障，正在尝试恢复 ¡ Shutdown：通道因故障关闭

1.1.2 grpc cpu-usage max-percent

grpc cpu-usage max-percent命令用来配置gRPC的CPU最大占用率。

undo grpc cpu-usage max-percent命令用来恢复缺省情况。

【命令】

grpc cpu-usage max-percent percentage

undo grpc cpu-usage max-percent

【视图】

系统视图

【缺省情况】

gRPC没有CPU占用率的限制。

【缺省用户角色】

network-admin

【参数】

percentage：CPU最大占用率，取值范围为1～50，单位为百分比。

【使用指导】

gRPC功能在采样数据时可能会占用大量CPU资源，为避免影响其他业务运行，可以配置gRPC的CPU最大占用率，使gRPC的CPU占用率超过配置值时，设备中止采样，等CPU占用率降低后再继续采样。

多次执行本命令，最后一次执行的命令生效。

【举例】

# 配置gRPC的CPU最大占用率为39%。

<Sysname> system-view

[Sysname] grpc cpu-usage max-percent 39

1.1.3 grpc data-model

grpc data-model命令用来配置gRPC使用的Telemetry数据模型。

undo grpc data-model命令用来恢复缺省情况。

【命令】

grpc data-model { 2-layer | 3-layer }

undo grpc data-model

【缺省情况】

设备使用二层Telemetry数据模型上送数据。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

2-layer：使用二层Telemetry数据模型上送数据。

3-layer：使用三层Telemetry数据模型上送数据。

【使用指导】

本命令目前仅用于gRPC Dial-out模式。

设备使用二层Telemetry数据模型上送数据时，不支持对上送数据使用GPB编码格式（encoding gpb）。

关于Telemetry数据模型的介绍，请参见“Telemetry配置指导”中的“gRPC”。

【举例】

# 配置设备使用三层Telemetry数据模型上送数据。

<Sysname> system-view

[Sysname] grpc data-model 3-layer

【相关命令】

· encoding

1.1.4 grpc enable

grpc enable命令用来开启gRPC功能。

undo grpc enable命令用来关闭gRPC功能。

【命令】

grpc enable

undo grpc enable

【缺省情况】

gRPC功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

应用场景

只有开启gRPC功能后，才能进行gRPC相关的配置。

注意事项

如果关闭gRPC功能，所有gRPC相关配置都会被删除。

【举例】

# 开启gRPC功能。

<Sysname> system

[Sysname] grpc enable

1.1.5 grpc pki domain

grpc pki domain命令用来配置设备和采集器建立gRPC连接时引用的PKI域。

undo grpc pki domain命令用来恢复缺省情况。

【命令】

grpc pki domain domain-name

undo grpc pki domain

【缺省情况】

设备和采集器建立gRPC连接时不会引用PKI域。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

domain-name：PKI域名，为1～31个字符的字符串，不区分大小写。

【使用指导】

缺省情况下，设备和采集器建立的gRPC连接是非加密的。配置本命令引用PKI域后，设备和采集器会基于TLS（Transport Layer Security，传输层安全）协议进行通道加密和双向证书认证，从而提高gRPC通信的安全性。

指定的PKI域必须存在，并且PKI域中包含完整的证书和密钥。关于PKI的配置，请参见“安全配置指导”中的“PKI”。

指定PKI域后，gRPC功能将重启，与采集器的连接将短暂断开。Dial-in模式下，采集器需要重新发送连接请求才能继续访问；Dial-out模式下，设备会自动连接采集器。

【举例】

# 配置设备和采集器建立gRPC连接时引用的PKI域为grpc_test。

<Sysname> system-view

[Sysname] grpc pki domain grpc_test

1.2 gRPC Dial-in模式配置命令

1.2.1 grpc compression

grpc compression命令用来配置gRPC服务器的数据压缩方式。

undo grpc compression命令用来恢复缺省情况。

【命令】

grpc compression gzip

undo grpc compression

【缺省情况】

gRPC服务器不压缩数据。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

gzip：gzip（GNU Zip）无损压缩方式。

【使用指导】

应用场景

通过配置gRPC服务器的数据压缩方式，可以在不影响数据完整性的情况下减少网络流量。

注意事项

修改gRPC服务器的数据压缩方式后，gRPC服务将重启，正在访问的gRPC客户端将被断开，gRPC客户端需要重新发送连接请求才能继续访问。

【举例】

# 配置gRPC服务器的数据压缩方式为gzip。

<Sysname> system

[Sysname] grpc compression gzip

1.2.2 grpc idle-timeout

grpc idle-timeout命令用来配置gRPC会话超时时间。

undo grpc idle-timeout命令用来恢复缺省情况。

【命令】

grpc idle-timeout minutes

undo grpc idle-timeout

【缺省情况】

gRPC会话超时时间为5分钟。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

minutes：表示gRPC会话超时时间，取值范围为0～30，单位为分钟。0表示设备不会因为超时自动断开用户连接。

【使用指导】

用户登录后，如果在超时时间内设备和用户之间没有gRPC报文交互，则超时时间到达时设备会自动断开该用户的连接。

【举例】

# 配置gRPC会话超时时间为6分钟。

<Sysname> system

[Sysname] grpc idle-timeout 6

1.2.3 grpc log dial-in gnmi

grpc log dial-in gnmi命令用来开启gRPC Dial-in模式的gNMI类操作日志功能。

undo grpc log dial-in gnmi命令用来关闭gRPC Dial-in模式的gNMI类操作日志功能。

【命令】

grpc log dial-in gnmi { all | { capabilities | get | set | subscribe }* }

undo grpc log dial-in gnmi { all | { capabilities | get | set | subscribe }* }

【缺省情况】

gRPC Dial-in模式的gNMI Set操作日志功能处于开启状态，其他gNMI类操作日志功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

all：表示输出所有gNMI类操作日志。

capabilities：表示输出gNMI Capabilities操作日志。

get：表示输出gNMI Get操作日志。

set：表示输出gNMI Set操作日志。

subscribe：表示输出gNMI Subscribe操作日志。

【使用指导】

应用场景

为了管理员定位gRPC问题的需要，可以开启gRPC日志功能，以便记录设备对gRPC报文的处理信息。

设备生成的gRPC日志信息会交给信息中心模块处理，信息中心模块的配置将决定日志信息的发送规则和发送方向。关于信息中心的详细描述请参见“网络管理和监控配置指导”中的“信息中心”。

注意事项

多次执行本命令，最终生效的是多次配置的集合。

【举例】

# 配置设备输出gRPC Dial-in模式的gNMI Get操作日志。

<Sysname> system

[Sysname] grpc log dial-in gnmi get

1.2.4 grpc log dial-in rpc

grpc log dial-in rpc命令用来开启gRPC Dial-in模式的RPC（Remote Procedure Call，远程过程调用）类操作日志功能。

undo grpc log dial-in rpc命令用来关闭gRPC Dial-in模式的RPC类操作日志功能。

【命令】

grpc log dial-in rpc { all | { cli | get }* }

undo grpc log dial-in rpc { all | { cli | get }* }

【缺省情况】

gRPC Dial-in模式的RPC类操作日志功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

all：表示输出CLI操作和Get操作的日志。

cli：表示输出CLI操作日志。

get：表示输出Get操作日志。

【使用指导】

应用场景

为了管理员定位gRPC问题的需要，可以开启gRPC日志功能，以便记录设备对gRPC报文的处理信息。

注意事项

多次执行本命令，最终生效的是多次配置的集合。

【举例】

# 配置设备输出gRPC Dial-in模式的Get操作的日志。

<Sysname> system

[Sysname] grpc log dial-in rpc get

1.2.5 grpc port

grpc port命令用来配置gRPC服务的端口号。

undo grpc port命令用来恢复缺省情况。

【命令】

grpc port port-number

undo grpc port

【缺省情况】

gRPC服务的端口号为50051。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

port-number：gRPC服务的端口号，取值范围为1～65535。

【使用指导】

修改端口号后，gRPC服务将重启，正在访问的客户端将被断开，客户端需要重新发送连接请求才能继续访问。

如果指定的端口号因端口被占用等原因无法用于gRPC服务，则系统使用修改前的端口号重启gRPC服务。

多次执行本命令，最后一次执行的命令生效。

【举例】

# 配置gRPC服务的端口号为50052。

<Sysname> system

[Sysname] grpc port 50052

【相关命令】

· grpc enable

1.3 gRPC Dial-out模式配置命令

1.3.1 destination-group (subscription view)

destination-group命令用来配置关联目标组。

undo destination-group命令用来删除关联目标组。

【命令】

destination-group group-name

undo destination-group group-name

【缺省情况】

未配置关联目标组。

【视图】

订阅视图

【缺省用户角色】

network-admin

【参数】

group-name：目标组的名称，为1～31个字符的字符串，区分大小写。

【使用指导】

工作机制

本命令配置的目标组将会和同一订阅视图下的传感器组自动关联。

注意事项

本命令指定的目标组需要先在Telemetry视图下使用destination-group命令创建。

同一目标组不支持同时在普通订阅和gNMI模式订阅中使用。

每个订阅可关联的目标组数量上限为5。

【举例】

# 在订阅A中配置关联目标组为collector1。

<Sysname> system-view

[Sysname] telemetry

[Sysname-telemetry] subscription A

[Sysname-telemetry-subscription-A] destination-group collector1

【相关命令】

· destination-group (telemetry view)

1.3.2 destination-group (telemetry view)

destination-group命令用来创建目标组，并进入目标组视图。如果指定的目标组已经存在，则直接进入目标组视图。

undo destination-group命令用来删除目标组。

【命令】

destination-group group-name

undo destination-group group-name

【缺省情况】

不存在目标组。

【视图】

Telemetry视图

【缺省用户角色】

network-admin

【参数】

group-name：目标组的名称，为1～31个字符的字符串，区分大小写。

【使用指导】

建议系统中创建的目标组数量不超过5个，否则会影响系统性能。

通过destination-group (subscription view)命令将目标组关联到订阅后，如需删除该目标组，请先解除订阅关系。

【举例】

# 创建名为collector1的目标组。

<Sysname> system-view

[Sysname] telemetry

[Sysname-telemetry] destination-group collector1

[Sysname-telemetry-destination-group-collector1]

【相关命令】

· destination-group (subscription view)

· subscription

1.3.3 display telemetry sensor-path

display telemetry sensor-path命令用来显示有最小采样周期的采样路径信息。

【命令】

display telemetry sensor-path

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【使用指导】

传感器组中采样路径的实际采样周期为以下两个值的较大值：

· 该采样路径的最小采样周期（可通过本命令显示的Min Interval(ms)字段查看）。

· 配置sensor-group (subscription view)命令时，为该传感器组指定的sample-interval参数值。

执行本命令后，采样路径信息按照如下顺序显示：

· 业务模块定制了最小采样周期的周期采样类型的采样路径。

· 周期采样类型的采样路径的缺省最小采样周期，不列出具体路径名。

【举例】

# 显示采样路径信息。

<Sysname> display telemetry sensor-path

Sampling Type Min Interval(ms) Sensor Path

Periodic 5000 diagnostic/cpuhistory

Periodic 5000 diagnostic/memories

Periodic 5000 diagnostic/porcessescpuhistory

...

Periodic 1000 (default-interval paths)

表1-3 display telemetry sensor-path显示信息描述表

字段	描述
Sampling Type	采样路径的类型，取值包括： · Periodic：按固定周期采样 · Event-triggered：由事件触发采样，本字段暂不支持
Min Interval(ms)	采样路径的最小采样周期，单位为毫秒
Sensor Path	采样路径名称 default-interval paths用来代表所有使用缺省最小采样周期的采样路径

【相关命令】

· sensor-group (subscription view)

1.3.4 domain-name

domain-name命令用来往目标组中添加指定域名的IPv4采集器。

undo domain-name命令用来将指定域名的IPv4采集器从目标组中删除。

【命令】

domain-name domain-name [ port port-number ] [ vpn-instance vpn-instance-name ] [ tls ]

undo domain-name domain-name [ port port-number ] [ vpn-instance vpn-instance-name ] [ tls ]

【缺省情况】

目标组中没有IPv4采集器。

【视图】

目标组视图

【缺省用户角色】

network-admin

【参数】

domain-name：采集器的IPv4地址对应的域名，为1～253个字符的字符串，不区分大小写，字符串中可以包含字母、数字、“-”、“_”和“.”。

port port-number：采集器接收数据的端口号，取值范围为1～65535，缺省值为50051。本参数的值需要和采集器侧的配置一致，否则采集器接收不到相应数据。

vpn-instance vpn-instance-name：采集器所属的VPN实例。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。指定的VPN实例必须已经存在。如果未指定本参数，则表示采集器位于公网中。

tls：配置设备和本命令配置的采集器建立gRPC连接时使用TLS（Transport Layer Security，传输层安全）加密，该加密方式使用设备出厂自带的证书。缺省情况下，设备和采集器建立的gRPC连接是非加密的。

【使用指导】

当使用域名指定采集器时，需要配置DNS（Domain Name System，域名系统），将采集器的域名解析为IPv4地址，订阅报文才能上送给采集器。关于域名解析的配置，请参见“三层技术-IP业务配置指导”中的“域名解析”。

可在设备上通过display dns host命令查看域名解析信息。如果一个域名对应多个IP地址，则DNS解析该域名得到的第一个路由可达的IP地址将作为订阅报文的上送地址。

多次执行本命令可配置多个采集器。注意：

· 配置本命令时，只要域名、端口号、VPN实例中任意一个属性不同，则被设备视为不同的采集器。

· 对同一采集器多次执行本命令，但是指定或不指定tls参数时，最后一次执行的命令生效。

每个目标组支持配置的采集器数量上限为5。

用户可以在系统视图下通过grpc pki domain命令全局配置TLS加密，也可以在目标组视图下配置与指定采集器之间的TLS加密，且系统视图下的配置优先级较高。

通过destination-group (subscription view)命令将目标组关联到订阅后，如需修改该目标组中的采集器配置，请先解除订阅关系。

【举例】

# 在目标组collector1中配置域名为sample.com的IPv4采集器。

<Sysname> system-view

[Sysname] telemetry

[Sysname-telemetry] destination-group collector1

[Sysname-telemetry-destination-group-collector1] domain-name sample.com

【相关命令】

· destination-group (subscription view)

· subscription

· display dns host（三层技术-IP业务命令参考/域名解析）

1.3.5 dscp

dscp命令用来配置设备发送的订阅报文的DSCP优先级。

undo dscp命令用来恢复缺省情况。

【命令】

dscp dscp-value

undo dscp

【缺省情况】

设备发送的订阅报文的DSCP优先级为0。

【视图】

订阅视图

【缺省用户角色】

network-admin

【参数】

dscp-value：订阅报文的DSCP优先级，取值范围为0～63。

【使用指导】

工作机制

DSCP（Differentiated Services Code Point，差分服务编码点）携带在IPv4报文中的ToS字段或者IPv6报文中的Traffic Class字段，用来体现报文自身的优先等级，决定报文传输的优先程度。DSCP优先级的取值越大，报文的优先级越高。

注意事项

在同一个订阅视图下多次执行本命令，最后一次执行的命令生效。

【举例】

# 配置设备发送的订阅A的报文的DSCP优先级为12。

<Sysname> system-view

[Sysname] telemetry

[Sysname-telemetry] subscription A

[Sysname-telemetry-subscription-A] dscp 12

1.3.6 encoding

encoding命令用来配置上送数据的编码格式。

undo encoding命令用来恢复缺省情况。

【命令】

encoding { gpb | json }

undo encoding

【缺省情况】

上送数据的编码格式为JSON。

【视图】

订阅视图

【缺省用户角色】

network-admin

【参数】

gpb：对上送数据使用GPB编码格式。仅当设备使用三层Telemetry数据模型时，可以对上送数据使用GPB编码格式。

json：对上送数据使用JSON编码格式。

【使用指导】

设备上支持订阅的数据均支持JSON编码格式，可能部分不支持GPB编码格式。当用户配置为GPB编码格式后，不支持GPB编码格式的数据不会上送。

gNMI模式的订阅不支持本功能。

【举例】

# 配置设备使用三层Telemetry数据模型，订阅A的上送数据的编码格式为GPB。

<Sysname> system-view

[Sysname] grpc data-model 3-layer

[Sysname] telemetry

[Sysname-telemetry] subscrption A

[Sysname-telemetry-subscription-A] encoding gpb

【相关命令】

· grpc data-model

1.3.7 grpc log dial-out

grpc log dial-out命令用来开启gRPC Dial-out模式的日志功能。

undo grpc log dial-out命令用来关闭gRPC Dial-out模式的日志功能。

【命令】

grpc log dial-out { all | { event | sample }* }

undo grpc log dial-out { all | { event | sample }* }

【缺省情况】

gRPC Dial-out模式的日志功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

all：表示输出gRPC Dial-out模式的所有类型的日志。

event：表示输出事件触发采样的日志。

sample：表示输出固定周期采样的日志。

【使用指导】

应用场景

为了管理员定位gRPC问题的需要，可以开启gRPC日志功能，以便记录设备对gRPC报文的处理信息。

gNMI模式的订阅不支持gRPC Dial-out模式的日志功能。

注意事项

多次执行本命令，最终生效的是多次配置的集合。

【举例】

# 配置设备输出gRPC Dial-out模式的固定周期采样的日志。

<Sysname> system

[Sysname] grpc log dial-out sample

1.3.8 ipv4-address

ipv4-address命令用来往目标组中添加IPv4采集器。

undo ipv4-address命令用来将IPv4采集器从目标组中删除。

【命令】

ipv4-address ipv4-address [ port port-number ] [ vpn-instance vpn-instance-name ] [ tls ]

undo ipv4-address ipv4-address [ port port-number ] [ vpn-instance vpn-instance-name ] [ tls ]

【缺省情况】

目标组中没有IPv4采集器。

【视图】

目标组视图

【缺省用户角色】

network-admin

【参数】

ipv4-address：采集器的IPv4地址。

port port-number：采集器接收数据的端口号，取值范围为1～65535，缺省值为50051。本参数的值需要和采集器侧的配置一致，否则采集器接收不到相应数据。

tls：配置设备和本命令配置的采集器建立gRPC连接时使用TLS加密，该加密方式使用设备出厂自带的证书。缺省情况下，设备和采集器建立的gRPC连接是非加密的。

【使用指导】

多次执行本命令可配置多个采集器。注意：

· 配置本命令时，只要IP地址、端口号、VPN实例中任意一个属性不同，则被设备视为不同的采集器。

· 对同一采集器多次执行本命令，但是指定或不指定tls参数时，最后一次执行的命令生效。

每个目标组支持配置的采集器数量上限为5。

通过destination-group (subscription view)命令将目标组关联到订阅后，如需修改该目标组中的采集器配置，请先解除订阅关系。

【举例】

# 在目标组collector1中配置IP地址为192.168.21.21的采集器。

<Sysname> system-view

[Sysname] telemetry

[Sysname-telemetry] destination-group collector1

[Sysname-telemetry-destination-group-collector1] ipv4-address 192.168.21.21

【相关命令】

· destination-group (subscription view)

· subscription

1.3.9 ipv6-address

ipv6-address命令用来往目标组中添加IPv6采集器。

undo ipv6-address命令用来将IPv6采集器从目标组中删除。

【命令】

ipv6-address ipv6-address [ port port-number ] [ vpn-instance vpn-instance-name ] [ tls ]

undo ipv6-address ipv6-address [ port port-number ] [ vpn-instance vpn-instance-name ] [ tls ]

【缺省情况】

目标组中没有IPv6采集器。

【视图】

目标组视图

【缺省用户角色】

network-admin

【参数】

ipv6-address：采集器的IPv6地址。

port port-number：采集器接收数据的端口号，取值范围为1～65535，缺省值为50051。本参数的值需要和采集器侧的配置一致，否则采集器接收不到相应数据。

【使用指导】

采集器的IPv6地址不能指定为IPv6链路本地地址。有关IPv6链路本地地址的介绍，请参见“三层技术-IP业务配置指导”中的“IPv6基础”。

多次执行本命令可配置多个采集器。注意：

· 配置本命令时，只要IP地址、端口号、VPN实例中任意一个属性不同，则被设备视为不同的采集器。

· 对同一采集器多次执行本命令，但是指定或不指定tls参数时，最后一次执行的命令生效。

每个目标组支持配置的采集器数量上限为5。

通过destination-group (subscription view)命令将目标组关联到订阅后，如需修改该目标组中的采集器配置，请先解除订阅关系。

【举例】

# 在目标组collector1中配置IPv6地址为1::1的采集器。

<Sysname> system-view

[Sysname] telemetry

[Sysname-telemetry] destination-group collector1

[Sysname-telemetry-destination-group-collector1] ipv6-address 1::1

【相关命令】

· destination-group (subscription view)

· subscription

1.3.10 ipv6 domain-name

ipv6 domain-name命令用来往目标组中添加指定域名的IPv6采集器。

undo ipv6 domain-name命令用来将指定域名的IPv6采集器从目标组中删除。

【命令】

ipv6 domain-name domain-name [ port port-number ] [ vpn-instance vpn-instance-name ] [ tls ]

undo ipv6 domain-name domain-name [ port port-number ] [ vpn-instance vpn-instance-name ] [ tls ]

【缺省情况】

目标组中没有IPv6采集器。

【视图】

目标组视图

【缺省用户角色】

network-admin

【参数】

domain-name：采集器的IPv6地址对应的域名，为1～253个字符的字符串，不区分大小写，字符串中可以包含字母、数字、“-”、“_”和“.”。

port port-number：采集器接收数据的端口号，取值范围为1～65535，缺省值为50051。本参数的值需要和采集器侧的配置一致，否则采集器接收不到相应数据。

【使用指导】

当使用域名指定采集器时，需要配置DNS，将采集器的域名解析为IPv6地址，订阅报文才能上送给采集器。关于域名解析的配置，请参见“三层技术-IP业务配置指导”中的“域名解析”。

多次执行本命令可配置多个采集器。注意：

· 配置本命令时，只要域名、端口号、VPN实例中任意一个属性不同，则被设备视为不同的采集器。

· 对同一采集器多次执行本命令，但是指定或不指定tls参数时，最后一次执行的命令生效。

每个目标组支持配置的采集器数量上限为5。

通过destination-group (subscription view)命令将目标组关联到订阅后，如需修改该目标组中的采集器配置，请先解除订阅关系。

【举例】

# 在目标组collector1中配置域名为sample.com的IPv6采集器。

<Sysname> system-view

[Sysname] telemetry

[Sysname-telemetry] destination-group collector1

[Sysname-telemetry-destination-group-collector1] ipv6 domain-name sample.com

【相关命令】

· destination-group (subscription view)

· subscription

· display dns host（三层技术-IP业务命令参考/域名解析）

1.3.11 json row-timestamp enable

json row-timestamp enable命令用来配置订阅报文的JSON格式业务数据按行打时间戳。

undo json row-timestamp enable命令用来恢复缺省情况。

【命令】

json row-timestamp enable

undo json row-timestamp enable

【缺省情况】

订阅报文的JSON格式业务数据按订阅报文打时间戳。

【视图】

订阅视图

【缺省用户角色】

network-admin

【使用指导】

工作机制

订阅报文的JSON格式业务数据支持按订阅报文打时间戳，或按行打时间戳。以Devi

热门推荐

热门推荐

H3C服务器

HPE服务器

热门推荐

H3C存储

HPE存储

热门推荐

商用台式机

商用笔记本

商用显示器

配件

热门推荐

热门推荐

智能终端

技术解决方案

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

专业安全服务

安全运营服务

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

技术支持

自助服务

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

公司刊物

加入我们

国家/地区

13-Telemetry命令参考

目录

01-gRPC命令

1 gRPC

1.1 gRPC通用配置命令

应用场景

注意事项

1.1.5 grpc pki domain

1.2 gRPC Dial-in模式配置命令

应用场景

注意事项

1.2.3 grpc log dial-in gnmi

应用场景

注意事项

应用场景

注意事项

1.3 gRPC Dial-out模式配置命令

工作机制

注意事项

1.3.3 display telemetry sensor-path

工作机制

注意事项

应用场景

注意事项

工作机制