H3C S9500 Command Manual-Release1648[v1.24]-08 System Volume

HomeSupportSwitchesH3C S9500 Series SwitchesReference GuidesCommand ReferencesH3C S9500 Command Manual-Release1648[v1.24]-08 System Volume
08-RMON Commands
Title Size Download
08-RMON Commands 63.83 KB

Chapter 1  RMON Configuration Commands

1.1  RMON Configuration Commands

1.1.1  display rmon alarm

Syntax

display rmon alarm [ alarm-table-entry ]

View

Any view

Parameters

alarm-table-entry: Alarm table entry index.

Description

Use the display rmon alarm command to view RMON alarm information.

Related commands: rmon alarm.

Examples

# Display the RMON alarm information.

<H3C> display rmon alarm

Alarm table 1 owned by monitor is VALID.

  Samples type          : delta

  Variable formula      : 1.3.6.1.2.1.16.1.1.1.3.1<etherStatsDropEvents.1>

  Description           : Ethernet5/1/1

  Sampling interval     : 10(sec)

  Rising threshold      : 10(linked with event 1)

  Falling threshold     : 2(linked with event 1)

  When startup enables  : risingOrFallingAlarm

  Latest value          : 0

Table 1-1 display rmon alarm command output description

Field

Description

Alarm table 1

Index 1 in alarm table

monitor

Owner

VALID

The alarm entry corresponding to this index is valid.

Samples type

Type of sampling

Variable formula

Variable parameters

Description

Description information

Sampling interval

Time interval for sampling

Rising threshold is 1000

The rising threshold is 1000.

Falling threshold is 100

The falling threshold is 100.

startup

First triggering

When startup enables: risingOrFallingAlarm

Type of the first alarm. The startup may trigger rising threshold alarm, falling threshold alarm, or both.

Latest value

Last sample value

 

1.1.2  display rmon event

Syntax

display rmon event [ event-table-entry ]

View

Any view

Parameters

event-table-entry: Entry index of event table.

Description

Use the display rmon event command to view RMON events.

The display includes event index in event table, owner of the event, description to the event, action caused by event (log or alarm information), and occurrence time of the latest event (counted on system initiate/boot time in centiseconds).

Related commands: rmon event.

Examples

# Show the RMON event.

<H3C> display rmon event

Event table 1 owned by null is VALID.

  Description: null.

  Will cause log-trap when triggered, last triggered at 0days 00h:02m:27s.

Table 1-2 display rmon event command output description

Field

Description

Event table 1

Index in event table

VALID

The entry corresponding to the index is valid

Description

Event description

Cause log-trap when triggered,

When the event is triggered, it will cause the log-trap.

Last triggered at 0days 00h:02m:27s

The last triggered time is 00h:02m:27s

 

1.1.3  display rmon eventlog

Syntax

display rmon eventlog [ event-number ]

View

Any view

Parameters

event-number: Entry index of event table.

Description

Use the display rmon eventlog command to view RMON event log.

The display includes event index in the event table, the status of the event, the time at which the event log is generated (this time starts from the system initialization or booting and counted in milliseconds), and event description.

Examples

# Show event log of RMON.

<H3C> display rmon eventlog 1

Event table 1 owned by null is VALID.

Generates eventLog 1.1 at 0days 00h:01m:39s.

Description: The 1.3.6.1.2.1.16.1.1.1.4.1 defined in alarm table 1,

less than(or =) 100 with alarm value 0. Alarm sample type is absolute.

Generates eventLog 1.2 at 0days 00h:02m:27s.

Description: The alarm formula defined in private alarm table 1,

less than(or =) 100 with alarm value 0. Alarm sample type is absolute.

Table 1-3 display rmon eventlog command output description

Field

Description

Event table 1

Index 1 in event table

VALID

The entry corresponding to the index is valid

Description

Event description

less than(or =) 100 with alarm value 0

The alarm sample value is less than or equal to 100

Alarm sample type is absolute

The type of alarm sampling is absolute

Generates eventLog 1.2 at 0days 00h:02m:27s

The eventlog corresponding to the index 1.2 is generated at 0days 00h:02m:27s.

 

1.1.4  display rmon history

Syntax

display rmon history [ port-num ]

View

Any view

Parameters

port-num: Ethernet port name.

Description

Use the display rmon history command to view latest RMON history sampling information (including utility, error number and total packet number).

Related commands: rmon history.

Examples

# Show the RMON history information.

<H3C> display rmon history ethernet 2/1/1

History control entry 1 owned by null is VALID

  Samples interface     : Ethernet2/1/1<ifEntry.642>

  Sampling interval     : 10(sec) with 10 buckets max

  Latest sampled values :

  Dropevents        :0         , octets               :0

  packets           :0         , broadcast packets    :0

  multicast packets :0         , CRC alignment errors :0

  undersize packets :0         , oversize packets     :0

  fragments         :0         , jabbers              :0

  collisions        :0         , utilization          :0

Table 1-4 display rmon history command output description

Field

Description

Samples interface

The sampled interface

History control entry

Index number in history control table

VALID

The entry corresponding to the index is valid

Sampling interval

Sampling interval

buckets

Records in history control table

Latest sampled values

The latest sample information

dropevents

Dropping packet events

octets

Sent/Received octets in sampling time

packets

Packets sent/received in sampling time

broadcast packets

Number of broadcast packets

multicast packets

Number of multicast packets

CRC alignment errors

Number of CRC error packets

undersized packets

Number of undersized packets

oversized packets

Number of oversized packets

fragments

Number of undersized and CRC error packets

jabbers

Number of oversized and CRC error packets

collisions

Number of collision packets

utilization

Utilization

 

1.1.5  display rmon prialarm

Syntax

display rmon prialarm [ prialarm-table-entry ]

View

Any view

Parameters

prialarm-table-entry: Entry index of extended RMON alarm table.

Description

Use the display rmon prialarm command to view information about extended RMON alarm table.

Related commands: rmon prialarm.

Examples

# Display the information about extended RMON alarm table.

<H3C> display rmon prialarm

Prialarm table 1 owned by monitor is UNDERCREATION.

  Samples type          : changeratio

  Variable formula      : (.1.3.6.1.2.1.2.2.1.10.201326601+.1.3.6.1.2.1.2.2.1.16

.201326601)*8*100/.1.3.6.1.2.1.2.2.1.5.201326601

  Description           : ifUtilization.Ethernet5/1/1

  Sampling interval     : 10(sec)

  Rising threshold      : 50(linked with event 1)

  Falling threshold     : 5(linked with event 1)

  When startup enables  : risingOrFallingAlarm

  This entry will exist : forever.

  Latest value          : 0

Table 1-5 display rmon prialarm command output description

Field

Description

Prialarm table 1

Index of extended alarm entry.

owned by monitor

Creator of the extended alarm entry.

UNDERCREATION

Status of expansion alarms

Samples type

Type of sampling

Variable formula

Formula for expansion alarms

Description

Description information

Sampling interval : 10(sec)

Sampling interval

Rising threshold          : 50

Rising threshold. When sampling value rises from normal value to this threshold, rising threshold alarm will be triggered.

Falling threshold         : 5

Falling threshold. When sampling value decreases from normal value to this threshold, falling threshold alarm will be triggered.

linked with event 1

Corresponding event index of ring and falling threshold alarm.

When startup enables: risingOrFallingAlarm

Kind of first alarm. It may trigger rising threshold alarm or falling threshold alarm or both.

This entry will exist forever

The lifespan of this alarm entry which can be forever or a specified period of time.

Latest value : 0

The value of the latest sampling.

 

1.1.6  display rmon statistics

Syntax

display rmon statistics [ port-num ]

View

Any view

Parameters

port-num: Ethernet port number.

Description

Use the display rmon statistics command to view RMON statistics.

The displayed information includes collision, CRC (Cyclic Redundancy Check) and queue, undersized or oversized packet, timeout, fragment, broadcast, multicast, unicast, and bandwidth utility.

Related commands: rmon statistics.

Examples

# Show RMON statistics.

<H3C> display rmon statistics Ethernet 2/1/1

Statistics entry 1 owned by aaa is VALID.

  Interface : Ethernet2/1/1<ifIndex.872418178>

  etherStatsOctets         : 756       , etherStatsPkts          : 9

  etherStatsBroadcastPkts  : 9         , etherStatsMulticastPkts : 0

  etherStatsUndersizePkts  : 0         , etherStatsOversizePkts  : 0

  etherStatsFragments      : 0         , etherStatsJabbers       : 0

  etherStatsCRCAlignErrors : 0         , etherStatsCollisions    : 0

  etherStatsDropEvents (insufficient resources): 0

  Packets received according to length (etherStatsPktsXXXtoYYYOctets):

  64     : 0         ,  65-127  : 444       ,  128-255  : 0

  256-511: 0         ,  512-1023: 0         ,  1024-max : 0

1.1.7  rmon alarm

Syntax

rmon alarm entry-number alarm-variable sampling-time { delta | absolute } rising-threshold threshold-value1 event-entry1 falling-threshold threshold-value2 event-entry2 [ owner text ]

undo rmon alarm entry-number

View

System view

Parameters

entry-number: Number of the entry to be added/deleted, ranging from 1 to 65535.

alarm-variable: Specifies the alarm variable with a character string, ranging from 1 to 256, in the OID dotted format, like 1.3.6.1.2.1.2.1.10.1 (or ifInOctets.1).

sampling-time: Specifies the sampling interval, ranging from 5 to 65535 (measured in seconds).

delta: Sampling type is delta.

absolute: Sampling type is absolute.

rising-threshold threshold-value1: Rising threshold, ranging from 0 to 2147483647.

event-entry1: Event number corresponding to the upper limit of threshold, ranging from 0 to 65535.

falling-threshold threshold-value2: Falling threshold, ranging from 0 to 2147483647.

event-entry2: Event number corresponding to the falling threshold, ranging from 0 to 65535.

owner text: Specifies the creator of the alarm. Length of the character string ranges from 1 to 127.

Description

Use the rmon alarm command to add an entry to the alarm table.

Use the undo rmon alarm command to cancel an entry from this table.

In this way, the alarm event can be triggered in the abnormal situations and then decides to log and send trap to the NM station.

 

&  Note:

Before adding an alarm entry, you need first to define the event to be referenced in the alarm entry using the rmon event command.

 

The system takes these actions on the defined alarm entries:

l           Sampling the defined alarm variables at a specified time interval.

l           Comparing the sample values against the predefined threshold and take further actions (see Table 1-6).

Table 1-6 Handling alarm entries

Item

Handling

The sample value is greater than the upper limit threshold-value1.

Triggers the defined event event-entry1

The sample value is less than the lower limit threshold-value2.

Triggers the defined event event-entry2

 

Examples

# Create alarm group

l           Configure an event before configuring “alarm” and “prialarm”.

[H3C]rmon event 1 log  owner test-rmon

l           View configuration information.

[H3C]display rmon event 1

Event table 1 owned by test-rmon is VALID.

  Description: null.

  Will cause log when triggered, last triggered at 1days 01h:42m:09s.

l           Configure alarm group.

# Add the first line in the alarm table. Sample the nodes 1.3.6.1.2.1.16.1.1.1.4.1 every 10 seconds. Trigger event 1 when the sampling value exceeds the upper threshold 50, and trigger event 2 when the sampling value gets below the lower threshold 5. The owner is user1.

<H3C> system-view

[H3C]rmon alarm 1 1.3.6.1.2.1.16.1.1.1.4.1 10 absolute rising_threshold 50 1 falling_threshold 5 2 owner user1

# Delete the information of entry 15 from the alarm table.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] undo rmon alarm 15

1.1.8  rmon event

Syntax

rmon event event-entry [ description string ] { log | trap trap-community | log-trap log-trapcommunity | none } [ owner text ]

undo rmon event event-entry

View

System view

Parameters

event-entry: Number of the entry to be added/deleted, ranging from 1 to 65535.

description string: Event description. Length of the character string ranges from 1 to 127.

log-trap log-trapcommunity: Defines the event as log and trap event, and specifies the community name of the NMS which receives the messages triggered by the event.

log: Log event.

trap trap-community: Defines the event as trap event, and specifies the community name of the NMS which receives the messages triggered by the event.

none: Neither log nor trap event.

owner text: Creator for this entry. The length of the character string ranges from 1 to 127.

Description

Use the rmon event command to add an entry to the event table.

Use the undo rmon event command to cancel an entry from this table.

RMON event management defines the event ID and the handling of the event.

You can handle the event in the following ways:

l           Keeping logs

l           Sending the trap messages to NMS

l           Keeping logs and sending the trap messages to NMS

Examples

# Add the entry 10 to the event table and marks it as log event.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] rmon event 10 log

1.1.9  rmon history

Syntax

rmon history entry-number buckets number interval sampling-interval [ owner text-string ]

undo rmon history entry-number

View

Ethernet port view

Parameters

entry-number: Number of the entry to be added/deleted, ranging from 1 to 65,535.

buckets number: Capacity of the history table corresponding to the control line.

interval sampling-interval: Sampling interval, ranging from 5 to 3600 (measured in seconds).

owner text-string: Creator of this entry. Length of the character string ranges from 1 to 127.

Description

Use the rmon history command to add an entry to the history control table.

Use the undo rmon history command to cancel an entry from history control table.

Perform this command to sample, set sample parameter (sample time interval) and storage amounts for a port. RMON will periodically perform data collection and save for query on this port. Sample information includes utility, error number and total packet number.

Related commands: display rmon history.

Examples

# Create a history control table entry with the index number of 15, capacity of 100 and sampling interval of 10 seconds. The owner is tester.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] interface Ethernet 2/1/1

[H3C-Ethernet2/1/1] rmon history 15 buckets 100 interval 10 owner tester

1.1.10  rmon prialarm

Syntax

rmon prialarm entry-number prialarm-formula prialarm-des sampling-timer { delta | absolute | changeratio } rising-threshold threshold-value1 event-entry1 falling-threshold threshold-value2 event-entry2 entrytype { forever | cycle cycle-period } [ owner text ]

undo rmon prialarm entry-number

View

System view

Parameters

entry-number: Specifies the entry number, ranging from 1 to 65535.

prialarm-formula: Variables in the formula must be represented by OID, for example, (1.3.6.1.2.1.2.1.10.1)*8. The operation results are in long integers. Every operation result must be within the range of the long integer; otherwise, errors may be prompted.

prialarm-des : Specifies the alarm description with a length ranging from 1 to 256;

sampling-timer: Sets the sampling interval, ranging from 10 to 65535 and measured in seconds.

delta | absolute | changeratio: Specifies the sampling type as delta ratio, absolute ratio or change ratio.

threshold-value1: Rising threshold value, specified with a number greater than 0.

event-entry1: Corresponding event number to the upper limit threshold value, ranging from 0 to 65535.

threshold-value2: Falling threshold value, specified with a number greater than 0.

event-entry2: Event number corresponding to the falling threshold, ranging from 0 to 65535.

forever | cycle cycle-period: Specifies the type of the alarm instance line.

cycle-period specifies the functional cycle of the instance.

owner text: Creator of this entry. Length of the character string ranges from 1 to 127.

Description

Use the rmon prialarm command to add an entry to the extended RMON alarm table.

Use the undo rmon prialarm command to cancel an entry from the extended RMON alarm table.

The number of instances can be created in the table depends on the hardware resource of the product.

 

&  Note:

Before adding an extended alarm entry, you need first to define the event to be referenced in the extended alarm entry using the rmon event command.

You can define up to 50 prialarm entries.

 

The system takes these actions on the extended alarm entries you defined:

l           Sampling the alarm variables in the defined extended alarm formula at a specified time interval.

l           Calculating the sample value using the defined extended alarm formula.

l           Comparing the sample values against the predefined threshold and take further actions (see Table 1-7).

Table 1-7 Handling extended alarm entries

Item

Handling

The calculated sample value is greater than the upper limit threshold-value1.

Triggers the defined event event-entry1

The calculated sample value is less than the lower limit threshold-value2.

Triggers the defined event event-entry2

 

Examples

# Add an extended alarm entry in the fifth line of the extended alarm table. Perform operation on the corresponding variant by means of the formula ((.1.3.6.1.4.1.43.45.1.6.1.2.1.1.2.1-.1.3.6.1.4.1.43.45.1.6.1.2.1.1.3.1)*100/.1.3.6.1.4.1.43.45.1.6.1.2.1.1.2.1) to get the port utilization of Gigabit Ethernet interface 1/1/1. Monitor the operation results at the sampling interval of 10 seconds. When the variation rate exceeds the upper threshold 50, trigger event 1; when the variation rate gets below the lower threshold 2, trigger event 2. Set the alarm instance sampling type to “forever”, and set the owner of the extended alarm table to “user1”.

<H3C> system-view

[H3C] rmon prialarm 5 ((.1.3.6.1.4.1.43.45.1.6.1.2.1.1.2.1-.1.3.6.1.4.1.43.45.1.6.1.2.1.1.3.1)*100/.1.3.6.1.4.1.43.45.1.6.1.2.1.1.2.1) ifUtilization.GigabitEthernet1/1/1 10 changeratio rising_threshold 50 1 falling_threshold 5 2 entrytype forever owner user1

# Delete line 10 from the extended RMON alarm table.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] undo rmon prialarm 10

1.1.11  rmon statistics

Syntax

rmon statistics entry-number [ owner text-string ]

undo rmon statistics entry-number

View

Ethernet port view

Parameters

entry-number: Number of the entry to be added/deleted, ranging from 1 to 65535.

owner text-string: Creator of this entry. Length of the character string ranges from 1 to 127.

Description

Use the rmon statistics command to add an entry to the statistic table.

Use the undo rmon statistics command to cancel an entry from statistic table.

RMON statistic management concerns the statistics and monitoring of the usage and error on a port. Statistics includes collision, undersized or oversized packet, timeout, fragment, broadcast, multicast, unicast, and bandwidth utility.

Related commands: display rmon statistics.

Examples

# Add statistics of Ethernet 2/1/1 to the entry 20.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C]interface Ethernet 2/1/1

[H3C-Ethernet2/1/1] rmon statistic 20

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become A Partner
  • Partner Policy & Program
  • Global Learning
  • Partner Sales Resources
  • Partner Business Management
  • Service Business
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网