No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

S600-E V200R013C00 Configuration Guide - Device Management

This document describes the configurations of Device Management, including device status query, hardware management, Stack, SVF, cloud-based management, PoE, OPS, energy-saving management, information center, fault management, NTP.
Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
Interface Statistics Collection Event Subscription

Interface Statistics Collection Event Subscription

Interface Name

Interface statistics collection event subscription

Application Phase

Subscription phase

API Prototype

result1_value, result2_description = ops.ifm.subscribe(tag, interface, monitor-packet, start-op, start-val, restart-op, restart-val, interval)

Description

Parameter

Description

Value

tag

Indicates conditions.

The value is a string of 1 to 12 case-insensitive characters, consists of letters, digits, and underscores (_), and starts with a letter. The value cannot be one of the following: "", None, and, or, andnot. The value cannot contain \0.

interface

Indicates the interface name consisting of the interface type and number.

The value is a string of characters and must be a complete interface name (GigabitEthernet0/0/1, for example) but not an abbreviation.

monitor-packet

Indicates the type of a monitored packet.

The value is of the enumerated type:

  • input-drops: number of packets discarded in the receive direction of an interface

  • input-errors: number of error packets received by an interface

  • output-drops: number of packets discarded in the transmit direction of an interface

  • output-errors: number of error packets send by an interface

  • rcv-bps: rate of received packets on an interface, in bit/s

  • rcv-broadcast: number of broadcast packets received by an interface

  • rcv-pps: rate of received packets on an interface, in pps

  • tx-bps: rate of sent packets on an interface, in bit/s

  • tx-pps: rate of sent packets on an interface, in pps

start-op

Indicates the operation code for triggering execution of a monitoring policy.

The value is of the enumerated type:

  • eq: equal to

  • ge: greater than or equal to

  • gt: greater than

  • le: less than or equal to

  • lt: less than

  • ne: not equal to

start-val

Indicates the value of a monitoring object that triggers execution of a monitoring policy.

The value is an integer that ranges from 0 to 4294967295. The unit depends on the value of monitor-packet.

restart-op

Indicates the operation code for turning on a trigger switch again.

The value is of the enumerated type:

  • eq: equal to

  • ge: greater than or equal to

  • gt: greater than

  • le: less than or equal to

  • lt: less than

  • ne: not equal to

restart-val

Indicates the value of a monitoring object that turns on the trigger switch again.

The value is an integer that ranges from 0 to 4294967295. The unit depends on the value of monitor-packet.

interval

Indicates the sampling interval for the monitoring object data.

The value is an integer that ranges from 20 to 4294967295, in seconds.

Return Value

The result1_value and result2_description in the API prototype indicate return values.

The result1_value is the first return value, 0 indicates success, and 1 indicates failure.

The result2_description is the second return value, indicating the failure cause. It is returned only when the first return value is 1.

Usage Description

If multiple simple events are defined using the ops.ifm.subscribe API in the subscription phase, but the simple events are not combined through the Multi-Condition Combination API, the Python script assistant cannot be configured.

Using the interface statistics collection event subscription, you can monitor statistics on sent and received packets on a specified interface. The process is as follows:

  1. Subscribe to this event, install the Python script, and configure the script assistant, and turn on the trigger switch immediately.
  2. When the number of specified packets on an interface meets conditions defined in start-op and start-val parameters, the corresponding action is triggered (first execution) and the trigger switch is turned off, but the system continues monitoring statistics collected on the interface.
  3. When conditions defined in restart-op and restart-val parameters are met, the trigger switch is turned on again.
  4. When the number of specified packets on an interface meets conditions defined in start-op and start-val parameters, the corresponding action is triggered again (second execution) and the trigger switch is turned off, but the system continues monitoring statistics collected on the interface.
  5. The process cycles in the specified sampling interval.

Example

Obtain the number of error packets received on GigabitEthernet0/0/1 every 60 seconds. When the number of error packets is greater than 1000, the corresponding action is triggered and the trigger switch is turned off. When the number of error packets is smaller than 50, the trigger switch is turned on again. This process cycles.

value, descri_str = ops.ifm.subscribe("err_packet", "GigabitEthernet0/0/1", "input-errors", "gt", 1000, "lt", 50, 60)
Translation
Download
Updated: 2019-04-20

Document ID: EDOC1100066159

Views: 25785

Downloads: 3

Average rating:
This Document Applies to these Products
Related Version
Related Documents
Share
Previous Next