Performance Monitor Configuration

14
July 2015 1 © 2015 Microsemi Corporation Application Note ENT-AN1109 Performance Monitor Configuration Performance Monitoring (PM) is a Carrier Ethernet software feature that collects, stores, and transfers statistics from the Operations, Administration and Management (OAM) engine according to a user's configuration. These statistics relate to delay, loss, Ethernet Virtual Connections (EVC), EVC Control Entry (ECE), and more. The user can select which data to collect as well as the intervals for collection and transfer. This document provides examples of how to setup the Performance Monitor feature with Microsemi’s Industrial Command Line Interface (ICLI). It also includes the command set and their meanings. Examples used in this document are specific to the VSC7418, but the software works similarly for other devices as well. Table of Contents Configuration Options This section describes the available configuration options. Session, Storage, and Transfer Configuration Up-MEP support is required for configuring the performance monitors. Add mep_loop_port to the following line in the configuration file (config.mk) to enable the VTSS_SW_OPTION_MEP_LOOP_PORT option in the source code. Custom/AddModules := mep_loop_port The device must be configured for EVC and ECE before gathering performance monitor information. Configuration Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Configuration Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Transcript of Performance Monitor Configuration

Page 1: Performance Monitor Configuration

Application Note ENT-AN1109

Performance Monitor Configuration

Performance Monitoring (PM) is a Carrier Ethernet software feature that collects, stores, and transfersstatistics from the Operations, Administration and Management (OAM) engine according to a user'sconfiguration. These statistics relate to delay, loss, Ethernet Virtual Connections (EVC), EVC ControlEntry (ECE), and more. The user can select which data to collect as well as the intervals for collectionand transfer.

This document provides examples of how to setup the Performance Monitor feature with Microsemi’sIndustrial Command Line Interface (ICLI). It also includes the command set and their meanings.

Examples used in this document are specific to the VSC7418, but the software works similarly for otherdevices as well.

Table of Contents

Configuration OptionsThis section describes the available configuration options.

Session, Storage, and Transfer ConfigurationUp-MEP support is required for configuring the performance monitors. Add mep_loop_port to thefollowing line in the configuration file (config.mk) to enable the VTSS_SW_OPTION_MEP_LOOP_PORToption in the source code.

Custom/AddModules := mep_loop_portThe device must be configured for EVC and ECE before gathering performance monitor information.

Configuration Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Configuration Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

July 2015 1

© 2015 Microsemi Corporation

Page 2: Performance Monitor Configuration

Performance Monitor Configuration Performance Monitor Configuration

Click Configuration > Performance Monitor to display the two choices, Configuration and TransferMode.

The following illustration shows the Configuration > Performance Monitor > Configuration options.

Session and storage configuration options are disabled by default. click the desired option to enable it.The following table lists the session and storage options.

Figure 1 • Performance Monitor Mode Configuration

Figure 2 • Session and Storage Configuration Options

22

Page 3: Performance Monitor Configuration

Configuration OptionsConfiguration Options

The following illustration shows the Configuration > Performance Monitor > Transfer Mode options.

Transfer configuration options are disabled by default. To enable, choose Enabled with the desiredsettings and click Save. The following table lists the transfer configuration options.

Table 1 • Sessions and Storage Options

Term Description

Type The data type of performance monitor.

Enable Session Enable or disable the performance monitor session.

Enable Storage Enable or disable he performance monitor storage.

Measurement Interval The measurement interval for the performance monitor.

Figure 3 • Transfer Configuration Options

Table 2 • Transfer Configuration Options

Term Description

PM Transfer Mode Configure the operation mode per system. Options are notavailable for a disabled mode.

Scheduled Hours Select one or more scheduled hours when the PM data transfer willoccur. The default is none selected. Multiple selections aresupported.

Scheduled Minutes Select one or more scheduled minutes when the PM data transferwill occur. The default is none selected. Multiple selections aresupported.

Measurement Interval The measurement interval for the performance monitor.

33

Page 4: Performance Monitor Configuration

Performance Monitor Configuration Performance Monitor Configuration

Scheduled Offset Specify a fixed offset to be added to the scheduled transfer time.The default is 0 minutes. The range is between 0 and 15 minutes.

Note: The sum of scheduled fixed offset and scheduled randomoffset must not exceed 15 minutes.

Random Offset Specify a random offset to be added to the scheduled transfer time.The default is 0 seconds. The range is between 0 to 900 seconds.

The offset added to the scheduled transfer time is a random valuein the range of 0 seconds to random offset.

Note: The sum of scheduled fixed offset and scheduled randomoffset must not exceed 15 minutes.

Server Directory URL The full URL of the server and the corresponding directory (if setproperly) for uploading.

HTTP and TFTP are supported.

To enable HTTP, use http://<domain name or IP address>

To enable TFTP, use tftp://<domain name or IP address>

Transfer Interval Mode Supported interval modes:

• All available intervals: To enable transfer of all completedmeasurement Intervals.

• New intervals since last transfer: To enable transfer of onlycompleted measurement Intervals since last transfer.

• Fixed number of intervals: To enable transfer of allcompleted measurement Intervals up to the configurednumber.

Number of intervals Specify the number of intervals to send when fixed number ofinterval is selected. The range is between 1 and 96 Intervals.

Transfer Option Select this option to include intervals from previous incompletetransfers.

Table 2 • Transfer Configuration Options (continued)

Term Description

44

Page 5: Performance Monitor Configuration

Configuration OptionsConfiguration Options

Statistics ReportingClick Monitor > Performance Monitor to display the available choices.

The available choices are as follows:

• LM Statistics

• DM Statistics

• EVC Statistics

• Interval Information

The following illustrations show the options available for each of the four statistics options.

Figure 4 • Performance Monitor Statistics Options

Figure 5 • Loss Measurement Statistics

55

Page 6: Performance Monitor Configuration

Performance Monitor Configuration Performance Monitor Configuration

Note: All measurement intervals are displayed if a measurement interval ID is not selected. The volume ofmeasurement data to be displayed can make this a very time consuming process.

ICLI Show CommandsShow commands are available under exec mode. Outside of the exec mode, the commands may beinvoked by the do show <show commands> command.

Show perf-mon current featureUse the following syntax to display the current performance monitor measurement data for a specifiedfeature.

show perf-mon current feature { dm | lm | evc }In the following example, 237 is the current Interval ID.

# show perf-mon current feature evc Interval ID : 237--------------------------------------------------------

EVC instance = 10 EVC port= 1Valid= yesTx green frames= 1002 Tx green bytes= 153602 Tx yellow frames= 0Tx yellow bytes= 0 Tx red frames= 0Tx red bytes= 0 Tx discard frames = 0 Tx discard bytes= 0 Rx green frames= 930

Figure 6 • Delay Measurement Statistics

Figure 7 • EVC Statistics

Figure 8 • Measurement Interval Information

66

Page 7: Performance Monitor Configuration

Configuration OptionsConfiguration Options

Rx green bytes= 142590 Rx yellow frames= 0Rx yellow bytes= 0 Rx red frames= 0Rx red bytes = 0 Rx discard frames = 0 Rx discard bytes = 0

Show perf-mon interval-id ID featureUse the following syntax to display the specified current performance monitor measurement data for aspecific interval and feature.

show perf-mon interval-id ID feature { dm | lm | evc }where ID is the integer value of the specified interval. For example, if 144 is the interval ID to be queried,it can be used as follows:

# show perf-mon interval-id 144 feature evc Interval ID : 144--------------------------------------------------------

EVC instance = 10 EVC port= 1Valid= yesTx green frames= 832Tx green bytes= 831020 Tx yellow frames= 0Tx yellow bytes= 0 Tx red frames= 0Tx red bytes= 0 Tx discard frames = 0Tx discard bytes= 0 Rx green frames= 533Rx green bytes= 501324Rx yellow frames= 0Rx yellow bytes= 0 Rx red frames= 0Rx red bytes = 0 Rx discard frames = 0 Rx discard bytes = 0

Show perf-mon interval-info featureUse the following syntax to show the list of performance monitor intervals of a specific feature.

show perf-mon interval-info feature { dm | lm | evc }When querying past measurement information a measurement ID needs to be queried first, as shown inthe following example.

# show perf-mon interval-info feature eve EVC Interval Information--------------------------------------------------------Measurement interval ID = 143Start time= 1970-01-01T02:01:25+00:00End time= 1970-01-01T02:02:25+00:00End time= 60 seconds Measurement interval ID = 144Start time= 1970-01-01T02:02:25+00:00End time= 1970-01-01T02:03:25+00:00End time= 60 seconds Measurement interval ID = 145Start time= 1970-01-01T02:03:25+00:00End time= 1970-01-01T02:04:25+00:00End time= 60 seconds…

77

Page 8: Performance Monitor Configuration

Performance Monitor Configuration Performance Monitor Configuration

ICLI Configuration CommandsConfiguration commands are available under the global configuration mode, which is invoked by the

configure terminal or conf t command. To exit global configure mode, type end.

# conf t(config)# perf-mon ?intervalMeasurement Interval sessionSession Enabled storageStorage Enabled transferTransfer Mode Enabled(config)# endThe following table shows the available commands and their usage.

Table 3 • Commands and Usage

Command Usage

perf-mon interval Set the measurement interval use.

perf-mon interval { dm | lm | evc } interval

where interval is an integer value within the range of 1 to 60 minutes.

perf-mon session Enable the performance monitor session for the feature(s) specified.

perf-mon session { dm | lm | evc }

Disable the performance monitor session for the feature(s) specified.

no perf-mon session { dm | lm | evc }

perf-mon transfer Configure the method and time used to handle the performance monitordata. When transfer is disabled, all transfer sub-commands are ineffective.

Enable the transfer of measurement data to the specified remote server.

perf-mon transfer

Disable the transfer of measurement data.

no perf-mon transfer

Specify the destination for the measurement data upload.

perf-mon transfer url URL

where URL can be in the following form.

tftp://<ip address>/

http://<domain name>/

tftp://<ip address>/

http://<domain name>/

Clear the transfer URL

no perf-mon transfer url

Set the transfer mode.

perf-mon transfer mode { all | fixed | new }

where:

All: All available intervals (default when none are specified)

Fixed: Fixed number of intervals

New: New intervals since last transfer

88

Page 9: Performance Monitor Configuration

Configuration ExampleConfiguration Example

Configuration ExampleThe following Performance Monitor configuration example is shown in both ICLI and GUI form. Theconfiguration is displayed by executing show running-config.

username admin privilege15 password noneevc 10 vid 1000 ivid 1000interface GigabitEthernet 1/3evc ece 1 interfaceGigabitEthernet 1/1 outer-tag match type tagged pcp 4-7 add pcp-mode mappeddei-mode dp evc 10 cos 4evc ece 2 interfaceGigabitEthernet 1/1 outer-tag add pcp-mode mapped dei-mode dp rule-type rx evc10 cos 0! vlan 1 name default!!

Enable the inclusion of previous incomplete transfers with the currentinterval transfer.

perf-mon transfer incomplete

Disable the inclusion of previous incomplete transfers with the currentinterval transfer.

no perf-mon transfer incomplete

Specify a transfer time. This command can be specified multiple times tospecify the different hours of a day. Transfer time is comprised of thefollowing commands.

perf-mon transfer hour <0-23>

perf-mon transfer minute { 0 | 15 | 30 | 45 }

perf-mon transfer fixed-offset <0-15>

perf-mon transfer random-offset <0-900>

The minute command can be specified multiple times to specify the differentminutes of an hour. If data is to be transferred four times per hour, set all ofthem. The fixed-offset is a single offset setting that is added to transfer hourand minute to allow a range between 0 and 15 minutes.

The random time offset is added to the previous time configurations andaccepts a value between 0 and 900 seconds. This is useful when allswitches are time synchronized and configuration is copied across allswitches. This avoids all switches uploading data at the same moment,which may overload the TFTP or HTTP server.

Each of the transfer time commands support a negate feature.

no perf-mon transfer hour no perf-mon transfer hour x no perf-mon transfer minute no perf-mon transfer minute x no perf-mon transfer fixed-offset no perf-mon transfer random-offsetCommands with parameters remove the indicated parameter only. If noparameter is provided, all settings for the command are removed.

Table 3 • Commands and Usage (continued)

Command Usage

99

Page 10: Performance Monitor Configuration

Performance Monitor Configuration Performance Monitor Configuration

!spanning-tree mst name00-01-c1-00-af-d0c2-30 revision 0 upnpaccess-list ace 1 policy42 tag-priority 0 frametypeframe-type etype dmac 01-80-c2-00-00-0e action denynetwork-clockwait-to-restore 5voice vlan oui 00-01-E3 description Siemens AGphonesvoice vlan oui 00-03-6B description Cisco phonesvoice vlan oui 00-0F-E2 description H3C phonesvoice vlan oui 00-60-B9 description Philips and NECAG phonesvoice vlan oui 00-D0-1E description Pingtel phonesvoice vlan oui 00-E0-75 description Polycom phonesvoice vlan oui 00-E0-BB description 3Com phonesperf-mon session lmperf-mon session dmperf-mon session evcperf-mon session eceperf-mon storage lm perf-mon storage dmperf-mon storage evcperf-mon storage eceperf-mon interval lm 1perf-mon interval dm 1perf-mon interval evc 1perf-mon interval ece1perf-mon transferperf-mon transfer hour 0perf-mon transfer hour 3perf-mon transfer hour 6perf-mon transfer hour 9perf-mon transfer hour 12perf-mon transfer hour 15perf-mon transfer hour 18perf-mon transfer hour 21perf-mon transfer minute 0perf-mon transfer minute15perf-mon transfer minute30perf-mon transfer minute45perf-mon transferfixed-offset 1perf-mon transfer urltftp://10.1.0.60/perf-mon transfer mode allperf-mon transferincomplete!interface GigabitEthernet1/1 switchport hybrid native vlan 4095 switchport hybrid allowed vlan none

1010

Page 11: Performance Monitor Configuration

Configuration ExampleConfiguration Example

switchport mode hybrid link-oam link-oam link-monitor supported!interface GigabitEthernet1/2!interface GigabitEthernet1/3 switchport hybrid native vlan 4095 switchport hybrid allowed vlan none switchport hybrid port-type s-port switchport mode hybrid link-oam link-oam mode active link-oam link-monitor supported!interface GigabitEthernet1/4!interface GigabitEthernet1/5!interface GigabitEthernet1/6!interface GigabitEthernet1/7!interface GigabitEthernet1/8!interface GigabitEthernet1/9!interface2.5GigabitEthernet 1/1!interface 2.5GigabitEthernet 1/2!interface vlan 1 ip address dhcp!mpls tp global-id 0 router-id0.0.0.0 icc-carrier-code NONE!mep os-tlv oui 0xC sub-type 0x1 value 0x2mep 1 down domain portflow 1 level 0 interface GigabitEthernet 1/1mep 1 voemep 1 peer-mep-id 2mep 1performance-monitoringmep 1 cc 0mep 3 down domain port flow3 level 0 interface GigabitEthernet 1/3

1111

Page 12: Performance Monitor Configuration

Performance Monitor Configuration Performance Monitor Configuration

mep 3 voemep 3 peer-mep-id 2mep 3performance-monitoringmep 3 cc 0mep 10 down domain evcflow 10 level 1 interface GigabitEthernet 1/3mep 10 voemep 10 peer-mep-id 2mep 10performance-monitoringmep 10 cc 4mep 20 up domain evcflow 10 level 2 interface GigabitEthernet 1/1mep 20 voemep 20 peer-mep-id 2mep 20performance-monitoringmep 20 cc 0eps 1 domain portarchitecture 1plus1 work-flow GigabitEthernet 1/1 protect-flow GigabitEthernet1/2eps 1 mep-work 3mep-protect 1 mep-aps 1eps 1 1plus1unidirectional!spanning-tree aggregation spanning-tree link-type point-to-point!!line console 0 exec-timeout 0 0 length 0!line vty 0!line vty 1!line vty 2!line vty 3!line vty 4!line vty 5!line vty 6!line vty 7!line vty 8!line vty 9!line vty 10!line vty 11!

1212

Page 13: Performance Monitor Configuration

Configuration ExampleConfiguration Example

line vty 12!line vty 13!line vty 14!line vty 15!endThe following illustration shows the session and storage configuration in the GUI.

The following illustration shows the transfer configuration in the GUI.

Figure 9 • PM Session and Storage Configuration

Figure 10 • PM Transfer Configuration

1313

Page 14: Performance Monitor Configuration

VPPD-03590. 1.1. July 2015

Microsemi makes no warranty, representation, or guarantee regarding the information contained herein orthe suitability of its products and services for any particular purpose, nor does Microsemi assume anyliability whatsoever arising out of the application or use of any product or circuit. The products soldhereunder and any other products sold by Microsemi have been subject to limited testing and should notbe used in conjunction with mission-critical equipment or applications. Any performance specifications arebelieved to be reliable but are not verified, and Buyer must conduct and complete all performance andother testing of the products, alone and together with, or installed in, any end-products. Buyer shall not relyon any data and performance specifications or parameters provided by Microsemi. It is the Buyer'sresponsibility to independently determine suitability of any products and to test and verify the same. Theinformation provided by Microsemi hereunder is provided “as is, where is” and with all faults, and the entirerisk associated with such information is entirely with the Buyer. Microsemi does not grant, explicitly orimplicitly, to any party any patent rights, licenses, or any other IP rights, whether with regard to suchinformation itself or anything described by such information. Information provided in this document isproprietary to Microsemi, and Microsemi reserves the right to make any changes to the information in thisdocument or to any products and services at any time without notice.

Power Matters.TM

Microsemi Corporation (Nasdaq: MSCC) offers a comprehensive portfolio of semiconductorand system solutions for communications, defense & security, aerospace and industrialmarkets. Products include high-performance and radiation-hardened analog mixed-signalintegrated circuits, FPGAs, SoCs and ASICs; power management products; timing andsynchronization devices and precise time solutions, setting the world's standard for time; voiceprocessing devices; RF solutions; discrete components; security technologies and scalableanti-tamper products; Ethernet solutions; Power-over-Ethernet ICs and midspans; as well ascustom design capabilities and services. Microsemi is headquartered in Aliso Viejo, Calif., andhas approximately 3,600 employees globally. Learn more at www.microsemi.com.

Microsemi Corporate HeadquartersOne Enterprise, Aliso Viejo,CA 92656 USA

Within the USA: +1 (800) 713-4113 Outside the USA: +1 (949) 380-6100Sales: +1 (949) 380-6136Fax: +1 (949) 215-4996E-mail: [email protected]

© 2015 Microsemi Corporation. Allrights reserved. Microsemi and theMicrosemi logo are trademarks ofMicrosemi Corporation. All othertrademarks and service marks are theproperty of their respective owners.