Contents

MOD commands· 1

collector 1

device-id· 2

display telemetry mod· 2

reason-list 4

sampler 5

telemetry mod· 5

transport-protocol 6

MOD commands

This feature is supported only in Release 6616 and later.

You can enable sampling for only one of the following features on the device:

·     MOD.

·     NetStream.

·     IPv6 NetStream.

·     Mirroring.

·     sFlow.

·     INT.

·     Telemetry stream.

For more information about NetStream, IPv6 NetStream, mirroring, and sFlow, see Network Management and Monitoring Configuration Guide. For more information about INT and telemetry stream, see Telemetry Configuration Guide.

collector

Use collector to configure the encapsulation information for packets sent to the collector by MOD.

Use undo collector to restore the default.

Syntax

collector source-ip source-address destination-ip destination-address source-port source-port destination-port destination-port [ vlan vlan-id ]

undo collector

Defaults

The encapsulation information for packets sent to the collector by MOD is not configured.

Views

MOD view

Predefined user roles

network-admin

Parameters

source-ip source-address: Specifies the source IP address for packets sent to the collector by MOD.

destination-ip destination-address: Specifies the destination IP address for packets sent to the collector by MOD.

source-port source-port: Specifies the source port number for packets sent to the collector by MOD.

destination-port destination-port: Specifies the destination port number for packets sent to the collector by MOD.

vlan vlan-id: Specifies the VLAN for packets sent to the collector by MOD.

Usage guidelines

The packets are encapsulated with the information specified by using this command and then routed to the remote collector.

Examples

# Encapsulate the packets sent to the collector by MOD with the following information: source IP address 10.10.10.10, destination IP address 20.20.20.20, source port number 10, and destination port number 20.

<Sysname> system-view

[Sysname] telemetry mod

[Sysname-telemetry-mod] collector source-ip 10.10.10.10 destination-ip 20.20.20.20 source-port 10 destination-port 20

Related commands

telemetry mod

device-id

Use device-id to configure the device ID for MOD.

Use undo device-id to restore the default.

Syntax

device-id address

undo device-id

Defaults

No device ID is configured for MOD.

Views

MOD view

Predefined user roles

network-admin

Parameters

address: Specifies the device ID for MOD. This argument can be any IPv4 address except 0.0.0.0. The device ID will be padded in the packets sent to the collector, so that the collector can identify the source of packets.

Examples

# Configure the device ID for MOD as 10.10.10.10.

<Sysname> system-view

[Sysname] telemetry mod

[Sysname-telemetry-mod] device-id 10.10.10.10

Related commands

telemetry mod

display telemetry mod

Use display telemetry mod to display MOD configuration information.

Syntax

display telemetry mod [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays entries on the master device.

Examples

# Display MOD configuration information.

<Sysname> system-view

[Sysname] display telemetry mod

Drop reason list   :

  invalid-tpid

  unknown-vlan

Sampler            : test1

Device ID          : 192.168.56.2

Transport protocol : UDP

Collector

  Source IP        : 1.1.1.1

  Destination IP   : 1.1.1.2

  Source port      : 80

  Destination port : 90

  VLAN ID          : 20

Table 1 Command output

Field	Description
Drop reason list	Packet drop reasons: ·     None—No packet drop reason is configured. ·     higig-header-error—HiGig header error. ·     invalid-tpid—Invalid TPID. ·     ip-multicast-error—IP multicast packet error. ·     ipv4-dip-miss—The destination IPv4 address of a packet does not match a route or matches the default route. ·     ipv4-l3-header-error—IPv4 header error. ·     parity-error—Parity error. ·     tunnel-header-error—Tunnel packet header error. ·     unknown-vlan—Unknown VLAN.
Transport protocol	Transport protocol that MOD uses to send packets to the collector: ·     gRPC. ·     UDP.
Collector	Encapsulation information for packets sent to the collector by MOD. ·     Source IP. ·     Destination IP. ·     Source port. ·     Destination port. ·     VLAN ID.

‌

reason-list

Use reason-list to configure a list of packet drop reasons monitored by MOD.

Use undo reason-list to remove a list of packet drop reasons monitored by MOD.

Syntax

reason-list { reason-list | all }

undo reason-list { reason-list | all }

Defaults

No packet drop reasons monitored by MOD are configured. The device does not monitor packet drops.

Views

MOD view

Predefined user roles

network-admin

Parameters

reason-list: Specifies a list of packet drop reasons. You can specify a space-separated list of up to eight reasons one time. Table 2 shows the possible packet drop reasons.

Table 2 Packet drop reasons

Value	Description
higig-header-error	HiGig header error.
invalid-tpid	Invalid TPID.
ip-multicast-error	IP multicast packet error.
ipv4-dip-miss	The destination IPv4 address of a packet does not match a route or matches the default route.
ipv4-l3-header-error	IPv4 header error.
parity-error	Parity error.
tunnel-header-error	Tunnel packet header error.
unknown-vlan	Unknown VLAN.

 

all: Specifies all packet drop reasons.

Usage guidelines

If you execute the reason-list reason-list command multiple times, the added packet drop reasons accumulate.

If you execute the undo reason-list reason-list command multiple times, the deleted packet drop reasons accumulated.

Examples

# Configure MOD to monitor all packet drop reasons.

<Sysname> system-view

[Sysname] telemetry mod

[Sysname-telemetry-mod] reason-list all

# Add packet drop reasons unknown-vlan to the list of packet drop reasons monitored by MOD.

<Sysname> system-view

[Sysname] telemetry mod

[Sysname-telemetry-mod] reason-list unknown-vlan

Related commands

telemetry mod

sampler

Use sampler to enable sampling for MOD.

Use undo sampler to disable sampling for MOD.

Syntax

sampler sampler-name

undo sampler

Defaults

Sampling is disabled for MOD.

Views

MOD view

Predefined user roles

network-admin

Parameters

sampler-name: Specifies a sampler by its name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

This command is required only for an MOD-mode flow group.

Examples

# Enable sampling for MOD, and use the sampler named sampler1.

<Sysname> system-view

[Sysname] telemetry mod

[Sysname-telemetry-mod] sampler sampler1

Related commands

sampler (Network Management and Monitoring Command Reference)

telemetry mod

telemetry mod

Use telemetry mod to enter MOD view.

Syntax

telemetry mod

Views

System view

Predefined user roles

network-admin

Examples

# Enter MOD view.

<Sysname> system-view

[Sysname] telemetry mod

[Sysname-telemetry-mod]

transport-protocol

Use transport-protocol to specify a protocol that MOD uses to send packets to the collector.

Use undo transport-protocol to restore the default.

Syntax

transport-protocol { grpc | udp }

undo transport-protocol

Default

MOD uses UDP to send packets to the collector.

Views

MOD view

Predefined user roles

network-admin

Parameters

grpc: Uses gRPC to send packets to the collector.

udp: Uses UDP to send packets to the collector.

Usage guidelines

If you use UDP to send packets to the collector, you must configure the encapsulation information by using the collector command.

Examples

# Specify UDP for MOD to use to send packets to the collector.

<Sysname> system-view

[Sysname] telemetry mod

[Sysname-telemetry-mod] transport-protocol udp

Related commands

collector

telemetry mod