Contents

MOD commands· 1

collector 1

device-id· 2

display telemetry mod· 2

reason-list 3

sampler 5

telemetry mod· 5

MOD commands

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 the slot number of the device, which is fixed at 1.

Examples

# Display MOD configuration information.

<Sysname> system-view

[Sysname] display telemetry mod

Status             : Successful

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

  Output interface : HundredGigE1/0/1

  Destination MAC  : 0011-0200-0211

Table 1 Command output

Field	Description
Status	MOD configuration deployment state: ·     Successful. ·     Failed. ·     Inactive—The reason-list command is not executed.
Drop reason list	Packet drop reasons (see Table 2). None indicates that no packet drop reason is configured.
Drop group list	This field is not supported in the current software version. Packet drop reason groups: ·     drop-precedence-drop—Drop reason group related to drop precedence. ·     invalid-queue-drop—Drop reason group related to invalid queues. ·     multicast-replication-fail—Drop reason group related to multicast replication failures. ·     pfc-fc-drop—Drop reason group related to PFC flow control. ·     tail-or-wred-drop—Drop reason group related to tail drop or WRED drop. ·     traffic-management-fail—Drop reason group related to traffic management failures. ·     user-defined—User-defined drop reason group. ·     voq-ram-drop—Drop reason group related to VOQ RAM drop.
Transport protocol	Transport protocol that MOD uses to send packets to the collector. In the current software version, only UDP is supported.
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
denied-vlan	The VLAN carried in the packet is not an allowed VLAN on the port.
dip-miss	The destination IPv4 or IPv6 address of a packet does not match a route.
inbound-ttl	TTL-related packet drop on the input interface.
invalid-tpid	Invalid TPID.
ip-multicast-error	This value is not supported in the current software version. IP multicast packet error.
l3-header-error	IPv4 or IPv6 header error.
mmu-drop	MMU-related packet drop.
parity-error	This value is not supported in the current software version. Parity error.
smac-zero	The source MAC address is all zeros.
source-miss	The source IPv4 or IPv6 address of a packet does not match a route.
tunnel-header-error	Tunnel packet header error.

‌

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

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.

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]