Table Of Contents
Prerequisites for the IP SLAs Ethernet Operation
Restrictions for the IP SLAs Ethernet Operation
Information About the IP SLAs Ethernet Operation
Benefits of the IP SLAs Ethernet Operation
IP SLAs Ethernet Operation Basics
How to Configure the IP SLAs Ethernet Operation
Configuring an IP SLAs Ethernet Operation with Endpoint Discovery
Manually Configuring an Individual IP SLAs Ethernet Operation
Configuration Examples for the IP SLAs Ethernet Operation
Configuring an IP SLAs Ethernet Operation with Endpoint Discovery: Example
Manually Configuring an Individual IP SLAs Ethernet Operation: Example
ip sla ethernet-monitor reaction-configuration
ip sla ethernet-monitor schedule
show ip sla ethernet-monitor configuration
Feature Information for the IP SLAs Ethernet Operation
IP SLAs for Metro-Ethernet
First Published: February 27, 2007Last Updated: February 27, 2007The IP Service Level Agreements (SLAs) for Metro-Ethernet feature provides the capability to gather Ethernet layer network performance metrics. This feature integrates Cisco IOS IP SLAs with the Ethernet Connectivity Fault Management (CFM) feature. Ethernet CFM is an end-to-end per-service-instance Ethernet layer operation, administration, and management (OAM) protocol. Available statistical measurements for the IP SLAs Ethernet operation include round-trip time, jitter (interpacket delay variance), and packet loss.
The IP SLAs for Metro-Ethernet feature also allows you to perform multioperation scheduling of IP SLAs operations and supports proactive threshold violation monitoring through Simple Network Management Protocol (SNMP) trap notifications and syslog messages.
Finding Feature Information in This Module
Your Cisco IOS software release may not support all of the features documented in this module. To reach links to specific feature documentation in this module and to see a list of the releases in which each feature is supported, use the "Feature Information for the IP SLAs Ethernet Operation" section.
Finding Support Information for Platforms and Cisco IOS and Catalyst OS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS and Catalyst OS software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Contents
•Prerequisites for the IP SLAs Ethernet Operation
•Restrictions for the IP SLAs Ethernet Operation
•Information About the IP SLAs Ethernet Operation
•How to Configure the IP SLAs Ethernet Operation
•Configuration Examples for the IP SLAs Ethernet Operation
•Feature Information for the IP SLAs Ethernet Operation
Prerequisites for the IP SLAs Ethernet Operation
It is recommended that the IEEE 802.1ag standard is supported on the destination devices in order to obtain complete error reporting and diagnostics information.
Note The destination devices do not require the IP SLAs Responder to be enabled.
Restrictions for the IP SLAs Ethernet Operation
Memory and performance may be impacted for a given Ethernet CFM maintenance domain and VLAN that has a large number of maintenance endpoints (MEPs).
Information About the IP SLAs Ethernet Operation
To configure an IP SLAs Ethernet operation, you should understand the following concepts:
•Benefits of the IP SLAs Ethernet Operation
•IP SLAs Ethernet Operation Basics
Benefits of the IP SLAs Ethernet Operation
•End-to-end connectivity measurements for determining network availability or testing network connectivity in service provider Ethernet networks
•Proactive threshold violation monitoring through SNMP trap notifications and syslog messages
•Reduced network troubleshooting time for service provider Ethernet networks
•Creation of IP SLAs Ethernet ping and Ethernet jitter operations based on network topology
•Discovery of existing maintenance endpoints (MEPs) in a given Ethernet CFM maintenance domain and VLAN based on the Ethernet CFM database
•Multioperation scheduling of IP SLAs operations
Ethernet CFM
Ethernet CFM is an end-to-end per-service-instance Ethernet layer operation, administration, and management (OAM) protocol. For more information about this feature, see the documentation for the Ethernet CFM feature. (See the "Related Documents" section for the location of this document.)
IP SLAs Ethernet Operation Basics
The IP SLAs for Metro-Ethernet feature integrates the IP SLAs software subsystem with the Ethernet CFM software subsystem to provide the capability to gather Ethernet layer statistical measurements by sending and receiving Ethernet data frames between Ethernet CFM maintenance endpoints (MEPs). The performance metrics for IP SLAs Ethernet operations are measured between a source MEP and a destination MEP. Unlike existing IP SLAs operations that provide performance metrics for the IP layer, the IP SLAs Ethernet operation provides performance metrics for Layer 2.
IP SLAs Ethernet operations may be configured using CLI or Simple Network Management Protocol (SNMP). You can manually configure individual Ethernet ping or Ethernet jitter operations by specifying the destination MEP identification number, name of the maintenance domain, and VLAN identification number. You also have the option to configure an IP SLAs auto Ethernet operation that will query the Ethernet CFM database for all maintenance endpoints in a given maintenance domain and VLAN and automatically create individual Ethernet ping or Ethernet jitter operations based on the MEPs that were discovered. A notification mechanism exists between the IP SLAs and Ethernet CFM subsystems to facilitate the automatic creation of Ethernet ping or Ethernet jitter operations for applicable MEPs that are added to a given maintenance domain and VLAN while an auto Ethernet operation is running.
The IP SLAs for Metro-Ethernet feature also allows you to perform multioperation scheduling of IP SLAs operations and supports proactive threshold violation monitoring through SNMP trap notifications and syslog messages. For more information on these topics, see the "Related Documents" section.
Statistics Measured by the IP SLAs Ethernet Operation
The network performance metrics supported by the IP SLAs Ethernet operation is similar to the metrics supported by existing IP SLAs operations. The statistical measurements supported by the IP SLAs Ethernet jitter operation include the following:
•Jitter (source-to-destination and destination-to-source)
•Round-trip time latency
•Unprocessed packets
•Packet loss (source-to-destination and destination-to-source)
•Out-of-sequence, tail-dropped, and late packets
How to Configure the IP SLAs Ethernet Operation
This section contains the following tasks:
•Configuring an IP SLAs Ethernet Operation with Endpoint Discovery
•Manually Configuring an Individual IP SLAs Ethernet Operation
Configuring an IP SLAs Ethernet Operation with Endpoint Discovery
Perform this task to configure and schedule an IP SLAs auto Ethernet operation.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla ethernet-monitor operation-number
4. type echo domain domain-name vlan vlan-id [exclude-mpids mp-ids]
or
type jitter domain domain-name vlan vlan-id [exclude-mpids mp-ids] [interval interframe-interval] [num-frames frames-number]5. cos cos-value
6. owner owner-id
7. request-data-size bytes
8. tag text
9. threshold milliseconds
10. timeout milliseconds
11. exit
12. ip sla ethernet-monitor reaction-configuration operation-number react monitored-element [action-type {none | trapOnly}] [threshold-type {average [number-of-measurements] | consecutive [occurrences] | immediate | never | xofy [x-value y-value]}] [threshold-value upper-threshold lower-threshold]
13. ip sla ethernet-monitor schedule operation-number schedule-period seconds [frequency [seconds]] [start-time {after hh:mm:ss | hh:mm[:ss] [month day | day month] | now | pending}]
14. exit
15. show ip sla ethernet-monitor configuration [operation-number]
DETAILED STEPS
Troubleshooting Tips
Use the debug ip sla trace and debug ip sla error commands to help troubleshoot issues with an individual IP SLAs Ethernet ping or Ethernet jitter operation. Use the debug ip sla ethernet-monitor command to help troubleshoot issues with an IP SLAs auto Ethernet operation.
What to Do Next
To display the results of an IP SLAs operation, use the show ip sla statistics and show ip sla statistics aggregated commands. Checking the output for fields that correspond to criteria in your service level agreement will help you determine whether the service metrics are acceptable.
Manually Configuring an Individual IP SLAs Ethernet Operation
Perform this task to manually configure and schedule an individual IP SLAs Ethernet ping or Ethernet jitter operation.
SUMMARY STEPS
1. enable
2. configure terminal
3. ip sla operation-number
4. ethernet echo mpid mp-id domain domain-name vlan vlan-id
or
ethernet jitter mpid mp-id domain domain-name vlan vlan-id [interval interframe-interval] [num-frames frames-number]5. cos cos-value
6. frequency seconds
7. history history-parameter
8. owner owner-id
9. request-data-size bytes
10. tag text
11. threshold milliseconds
12. timeout milliseconds
13. exit
14. ip sla reaction-configuration operation-number react monitored-element [action-type option] [threshold-type {average [number-of-measurements] | consecutive [occurrences] | immediate | never | xofy [x-value y-value]}] [threshold-value upper-threshold lower-threshold]
15. ip sla schedule operation-number [life {forever | seconds}] [start-time {hh:mm[:ss] [month day | day month] | pending | now | after hh:mm:ss] [ageout seconds] [recurring]
16. exit
17. show ip sla configuration [operation-number]
DETAILED STEPS
Troubleshooting Tips
Use the debug ip sla trace and debug ip sla error commands to help troubleshoot issues with an individual IP SLAs Ethernet ping or Ethernet jitter operation.
What to Do Next
To display the results of an IP SLAs operation use the show ip sla statistics and show ip sla statistics aggregated commands. Checking the output for fields that correspond to criteria in your service level agreement will help you determine whether the service metrics are acceptable.
Configuration Examples for the IP SLAs Ethernet Operation
This section provides the following configuration examples:
•Configuring an IP SLAs Ethernet Operation with Endpoint Discovery: Example
•Manually Configuring an Individual IP SLAs Ethernet Operation: Example
Configuring an IP SLAs Ethernet Operation with Endpoint Discovery: Example
The following example shows how to configure operation parameters, proactive threshold monitoring, and scheduling options using an IP SLAs auto Ethernet operation. In this example, operation 10 is configured to automatically create IP SLAs Ethernet ping operations for all the discovered maintenance endpoints in the domain named testdomain and VLAN identification number 34. As specified by the proactive threshold monitoring configuration, when three consecutive connection loss events occur, an SNMP trap notification should be sent. The schedule period for operation 10 is 60 seconds, and the operation is scheduled to start immediately.
ip sla ethernet-monitor 10type echo domain testdomain vlan 34!ip sla ethernet-monitor reaction-configuration 10 react connectionLoss threshold-type consecutive 3 action-type trapOnly!ip sla ethernet-monitor schedule 10 schedule-period 60 start-time now
Manually Configuring an Individual IP SLAs Ethernet Operation: Example
The following example shows how to configure an IP SLAs Ethernet ping operation. In this example, the maintenance endpoint identification number is 23, the maintenance domain name is testdomain, and the VLAN identification number is 34. As specified by the proactive threshold monitoring configuration, when three consecutive connection loss events occur, an SNMP trap notification should be sent. Operation 1 is scheduled to start immediately.
ip sla 1ethernet echo mpid 23 domain testdomain vlan 34!ip sla reaction-configuration 1 react connectionLoss threshold-type consecutive 3 action-type trapOnly!ip sla schedule 1 start-time now
Where to Go Next
If you want to configure other types of IP SLAs operations, see the Cisco IOS IP SLAs Configuration Guide, Release 12.4T.
Additional References
The following sections provide references related to the IP SLAs for Metro-Ethernet feature.
Related Documents
Related Topic Document TitleEthernet CFM
Ethernet Connectivity Fault Management feature module, Cisco IOS Release 12.2(33)SRB
Multioperation scheduling for Cisco IOS IP SLAs
"IP SLAs—Multiple Operation Scheduling" chapter of the Cisco IOS IP SLAs Configuration Guide, Release 12.4T
Proactive threshold monitoring for Cisco IOS IP SLAs
"IP SLAs—Proactive Threshold Monitoring" chapter of the Cisco IOS IP SLAs Configuration Guide, Release 12.4T
Cisco IOS IP SLAs command line interface enhancements
Cisco IOS IP Service Level Agreements Command Line Interface, Cisco white paper
Cisco IOS IP SLAs configuration tasks
Cisco IOS IP SLAs Configuration Guide, Release 12.4T
Cisco IOS IP SLAs commands
Standards
MIBs
MIB MIBs Link•CISCO-RTTMON-MIB
•CISCO-IPSLA-ETHERNET-MIB
To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:
RFCs
RFC TitleNo new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.
—
Technical Assistance
Command Reference
This section documents new commands only.
•cos
•debug ip sla ethernet-monitor
•ip sla ethernet-monitor reaction-configuration
•ip sla ethernet-monitor schedule
•show ip sla ethernet-monitor configuration
cos
To set the class of service (CoS) for a Cisco IOS IP Service Level Agreements (SLAs) Ethernet operation, use the cos command in the appropriate submode of IP SLA configuration or IP SLA Ethernet monitor configuration mode. To return to the default value, use the no form of this command.
cos cos-value
no cos
Syntax Description
Command Default
The class of service value for the IP SLAs Ethernet operation is set to 0.
Command Modes
IP SLA configuration
Ethernet echo configuration (config-ip-sla-ethernet-echo)
Ethernet jitter configuration (config-ip-sla-ethernet-jitter)IP SLA Ethernet monitor configuration
Ethernet parameters configuration (config-ip-sla-ethernet-params)
Note The configuration mode varies depending on the operation type configured. See the "Usage Guidelines" section for more information.
Command History
Usage Guidelines
You must configure the type of IP SLAs operation (such as Ethernet ping) before you can configure any of the other parameters of the operation.
The configuration mode for the cos command varies depending on the operation type configured. For example, if you are running Cisco IOS Release 12.2(33)SRB and the Ethernet ping operation type is configured using the ethernet echo mpid command in IP SLA configuration mode, you would enter the cos command in Ethernet echo configuration mode (config-ip-sla-ethernet-echo).
Examples
The following example shows how to configure operation parameters, proactive threshold monitoring, and scheduling options using an IP SLAs auto Ethernet operation. In this example, operation 10 is configured to automatically create IP SLAs Ethernet ping operations for all the discovered maintenance endpoints in the domain named testdomain and VLAN identification number 34. The class of service for each Ethernet ping operation is set to 3. As specified by the proactive threshold monitoring configuration, when three consecutive connection loss events occur, a Simple Network Management Protocol (SNMP) trap notification should be sent. The schedule period for operation 10 is 60 seconds, and the operation is scheduled to start immediately.
ip sla ethernet-monitor 10type echo domain testdomain vlan 34cos 3!ip sla ethernet-monitor reaction-configuration 10 react connectionLoss threshold-type consecutive 3 action-type trapOnly!ip sla ethernet-monitor schedule 10 schedule-period 60 start-time nowRelated Commands
debug ip sla ethernet-monitor
To enable debugging output for a Cisco IOS IP Service Level Agreements (SLAs) Ethernet operation, use the debug ip sla ethernet-monitor command in privileged EXEC mode. To disable debugging output, use the no form of this command.
debug ip sla ethernet-monitor [operation-number]
no debug ip sla ethernet-monitor [operation-number]
Syntax Description
operation-number
(Optional) Number of the Ethernet operation for which the debugging output will be displayed.
Command Default
Debug is not enabled.
Command Modes
Privileged EXEC
Command History
Examples
The following is sample output from the debug ip sla ethernet-monitor command:
Router# debug ip sla ethernet-monitor00:00:15: IP SLAs Auto Ethernet(0):vlan = 2, domain = DOMAIN_OPERATOR_L3_1, mpid = 6322from CFM00:00:15: IP SLAs Auto Ethernet(0):saaHandleEventFromCFM::Received Event from CFM00:00:15: IP SLAs Auto Ethernet(0):Event::ECFM_SAA_EV_MEP_ADD00:00:15: IP SLAs Auto Ethernet(0):1 auto-probes found for domain = DOMAIN_OPERATOR_L3_1 and vlan = 200:00:15: IP SLAs Auto Ethernet(0):autoProbe probe_id = 100:00:15: IP SLAs Auto Ethernet(0):0 Probes already running in auto-probe = 100:00:15: IP SLAs Auto Ethernet(1):starting probe with freq = 20 sec00:00:15: IP SLAs Auto Ethernet(1):starting probe 100001Related Commands
ethernet echo mpid
To manually configure an individual Cisco IOS IP Service Level Agreements (SLAs) Ethernet ping operation, use the ethernet echo mpid command in IP SLA configuration mode.
ethernet echo mpid mp-id domain domain-name vlan vlan-id
Syntax Description
Command Default
No IP SLAs Ethernet ping operation is configured.
Command Modes
IP SLA configuration (config-ip-sla)
Command History
Usage Guidelines
You must configure the type of IP SLAs operation (such as Ethernet ping) before you can configure any of the other parameters of the operation. To change the operation type of an existing IP SLAs operation, you must first delete the IP SLAs operation (using the no ip sla global configuration command) and then reconfigure the operation with the new operation type.
Examples
The following example shows how to configure an IP SLAs Ethernet ping operation. In this example, the maintenance endpoint identification number is 23, the maintenance domain name is testdomain, and the VLAN identification number is 34. Operation 1 is scheduled to start immediately.
ip sla 1ethernet echo mpid 23 domain testdomain vlan 34!ip sla schedule 1 start-time nowRelated Commands
Command Descriptionip sla
Begins configuration for an IP SLAs operation and enters IP SLA configuration mode.
ethernet jitter mpid
To manually configure an individual Cisco IOS IP Service Level Agreements (SLAs) Ethernet jitter operation, use the ethernet jitter mpid command in IP SLA configuration mode.
ethernet jitter mpid mp-id domain domain-name vlan vlan-id [interval interframe-interval] [num-frames frames-number]
Syntax Description
Command Default
No IP SLAs Ethernet jitter operation is configured.
Command Modes
IP SLA configuration (config-ip-sla)
Command History
Usage Guidelines
You must configure the type of IP SLAs operation (such as Ethernet jitter) before you can configure any of the other parameters of the operation. To change the operation type of an existing IP SLAs operation, you must first delete the IP SLAs operation (using the no ip sla global configuration command) and then reconfigure the operation with the new operation type.
Examples
The following example shows how to configure an IP SLAs Ethernet jitter operation. In this example, the maintenance endpoint identification number is 23, the maintenance domain name is testdomain, the VLAN identification number is 34, the interframe interval is 20 ms, and the number of frames to be sent is 30. Operation 2 is scheduled to start immediately.
ip sla 2ethernet jitter mpid 23 domain testdomain vlan 34 interval 20 num-frames 30!ip sla schedule 2 start-time nowRelated Commands
Command Descriptionip sla
Begins configuration for an IP SLAs operation and enters IP SLA configuration mode.
ip sla ethernet-monitor
To begin configuring an Cisco IOS IP Service Level Agreements (SLAs) auto Ethernet operation and enter IP SLA Ethernet monitor configuration mode, use the ip sla ethernet-monitor command in global configuration mode. To remove all configuration information for an auto Ethernet operation, including the schedule of the operation, reaction configuration, and reaction triggers, use the no form of this command.
ip sla ethernet-monitor operation-number
no ip sla ethernet-monitor operation-number
Syntax Description
operation-number
Operation number used for the identification of the IP SLAs operation you want to configure.
Command Default
No IP SLAs operation is configured.
Command Modes
Global configuration
Command History
Usage Guidelines
The ip sla ethernet-monitor command is used to begin configuration for an IP SLAs auto Ethernet operation. Use this command to specify an identification number for the operation you are about to configure. After you enter this command, the router will enter IP SLA Ethernet monitor configuration mode.
After you configure an auto Ethernet operation, you must schedule the operation. To schedule an auto Ethernet operation, use the ip sla ethernet-monitor schedule command in global configuration mode. You can also optionally set reaction configuration for the operation (see the ip sla ethernet-monitor reaction-configuration command).
To display the current configuration settings of an auto Ethernet operation, use the show ip sla ethernet-monitor configuration command in user EXEC or privileged EXEC mode.
To change the operation type of an existing auto Ethernet operation, you must first delete the operation (using the no ip sla ethernet-monitor global configuration command) and then reconfigure the operation with the new operation type.
Examples
The following example shows how to configure operation parameters, proactive threshold monitoring, and scheduling options using an IP SLAs auto Ethernet operation. In this example, operation 10 is configured to automatically create IP SLAs Ethernet ping operations for all the discovered maintenance endpoints in the domain named testdomain and VLAN identification number 34. As specified by the proactive threshold monitoring configuration, when three consecutive connection loss events occur, a Simple Network Management Protocol (SNMP) trap notification should be sent. The schedule period for operation 10 is 60 seconds, and the operation is scheduled to start immediately.
ip sla ethernet-monitor 10type echo domain testdomain vlan 34!ip sla ethernet-monitor reaction-configuration 10 react connectionLoss threshold-type consecutive 3 action-type trapOnly!ip sla ethernet-monitor schedule 10 schedule-period 60 start-time nowRelated Commands
ip sla ethernet-monitor reaction-configuration
To configure proactive threshold monitoring parameters for a Cisco IOS IP Service Level Agreements (SLAs) auto Ethernet operation, use the ip sla ethernet-monitor reaction-configuration command in global configuration mode. To clear all threshold monitoring configuration for a specified auto Ethernet operation, use the no form of this command.
ip sla ethernet-monitor reaction-configuration operation-number react monitored-element [action-type {none | trapOnly}] [threshold-type {average [number-of-measurements] | consecutive [occurrences] | immediate | never | xofy [x-value y-value]}] [threshold-value upper-threshold lower-threshold]
no ip sla ethernet-monitor reaction-configuration operation-number
Syntax Description
operation-number
Number of the IP SLAs operation for which reactions are to be configured.
react monitored-element
Specifies the element to be monitored for threshold violations. Keyword options for the monitored-element argument are as follows:
•connectionLoss—Specifies that a reaction should occur if there is a one-way connection loss for the monitored operation.
•jitterAvg—Specifies that a reaction should occur if the average round-trip jitter value violates the upper threshold or lower threshold.
•jitterDSAvg—Specifies that a reaction should occur if the average one-way destination-to-source jitter value violates the upper threshold or lower threshold.
•jitterSDAvg—Specifies that a reaction should occur if the average one-way source-to-destination jitter value violates the upper threshold or lower threshold.
•maxOfNegativeDS—Specifies that a reaction should occur if the one-way maximum negative jitter destination-to-source threshold is violated.
•maxOfNegativeSD—Specifies that a reaction should occur if the one-way maximum negative jitter source-to-destination threshold is violated.
•maxOfPositiveDS—Specifies that a reaction should occur if the one-way maximum positive jitter destination-to-source threshold is violated.
•maxOfPositiveSD—Specifies that a reaction should occur if the one-way maximum positive jitter source-to-destination threshold is violated.
react monitored-element (continued)
•packetLateArrival—Specifies that a reaction should occur if the one-way number of late packets violates the upper threshold or lower threshold.
•packetLossDS—Specifies that a reaction should occur if the one-way destination-to-source packet loss value violates the upper threshold or lower threshold.
•packetLossSD—Specifies that a reaction should occur if the one-way source-to-destination packet loss value violates the upper threshold or lower threshold.
•packetMIA—Specifies that a reaction should occur if the one-way number of missing packets violates the upper threshold or lower threshold.
•packetOutOfSequence—Specifies that a reaction should occur if the one-way number of packets out of sequence violates the upper threshold or lower threshold.
•rtt—Specifies that a reaction should occur if the round-trip time violates the upper threshold or lower threshold.
•timeout—Specifies that a reaction should occur if there is a one-way timeout for the monitored operation.
action-type none
(Optional) Specifies that no action is taken when threshold events occur. The none keyword is the default value.
Note If the threshold-type never keywords are configured, the action-type keyword is disabled.
action-type trapOnly
(Optional) Specifies that a Simple Network Management Protocol (SNMP) trap notification should be sent when threshold violation events occur.
Note If the threshold-type never keywords are configured, the action-type keyword is disabled.
threshold-type average [number-of-measurements]
(Optional) Specifies that when the average of a specified number of measurements for the monitored element exceeds the upper threshold or when the average of a specified number of measurements for the monitored element drops below the lower threshold, the action defined by the action-type keyword should be performed. For example, if the upper threshold for react rtt threshold-type average 3 is configured as 5000 ms and the last three results of the operation are 6000, 6000, and 5000 ms, the average would be 6000 + 6000 + 5000 = 17000/3 = 5667. In this case, the average exceeds the upper threshold.
The default number of 5 averaged measurements can be changed using the number-of-measurements argument. The valid range is from 1 to 16.
This syntax is not available if the connectionLoss or timeout keyword is specified as the monitored element, because upper and lower thresholds do not apply to these options.
threshold-type consecutive [occurrences]
(Optional) Specifies that when a threshold violation for the monitored element is met consecutively for a specified number of times, the action defined by the action-type keyword should be performed.
The default number of 5 consecutive occurrences can be changed using the occurrences argument. The valid range is from 1 to 16.
threshold-type immediate
(Optional) Specifies that when a threshold violation for the monitored element is met, the action defined by the action-type keyword should be performed immediately.
threshold-type never
(Optional) Specifies that threshold violations should not be monitored. This is the default threshold type.
threshold-type xofy [x-value y-value]
(Optional) Specifies that when a threshold violation for the monitored element is met x number of times within the last y number of measurements ("x of y"), action defined by the action-type keyword should be performed.
The default is 5 for both the x and y values (xofy 5 5). The valid range for each value is from 1 to 16.
threshold-value [upper-threshold lower-threshold]
(Optional) Specifies the upper-threshold and lower-threshold values of the applicable monitored elements. See Table 1 in the "Usage Guidelines" section for a list of the default values.
Command Default
IP SLAs proactive threshold monitoring is disabled.
Command Modes
Global configuration
Command History
Usage Guidelines
You can configure the ip sla ethernet-monitor reaction-configuration command multiple times to enable proactive threshold monitoring for multiple elements (for example, configuring thresholds for round-trip time and destination-to-source packet loss) for the same operation. However, disabling of individual monitored elements is not supported. In other words, the no ip sla ethernet-monitor reaction-configuration command will disable all proactive threshold monitoring configuration for the specified IP SLAs operation.
SNMP traps for IP SLAs are supported by the CISCO-RTTMON-MIB and CISCO-SYSLOG-MIB. Use the ip sla logging traps command to enable the generation of SNMP system logging messages specific to IP SLAs trap notifications. Use the snmp-server enable traps rtr command to enable the sending of IP SLAs SNMP trap notifications.
To display the current threshold monitoring configuration settings for an auto Ethernet operation, use the show ip sla ethernet-monitor configuration command.
Table 1 lists the default upper and lower thresholds for specific monitored elements.
Examples
The following example shows how to configure operation parameters, proactive threshold monitoring, and scheduling options using an IP SLAs auto Ethernet operation. In this example, operation 10 is configured to automatically create IP SLAs Ethernet ping operations for all the discovered maintenance endpoints in the domain named testdomain and VLAN identification number 34. As specified by the proactive threshold monitoring configuration, when three consecutive connection loss events occur, an SNMP trap notification should be sent. The schedule period for operation 10 is 60 seconds, and the operation is scheduled to start immediately.
ip sla ethernet-monitor 10type echo domain testdomain vlan 34!ip sla ethernet-monitor reaction-configuration 10 react connectionLoss threshold-type consecutive 3 action-type trapOnly!ip sla ethernet-monitor schedule 10 schedule-period 60 start-time nowRelated Commands
ip sla ethernet-monitor schedule
To configure the scheduling parameters for an IP Service Level Agreements (SLAs) auto Ethernet operation, use the ip sla ethernet-monitor schedule command in global configuration mode. To stop the operation and place it in the default state (pending), use the no form of this command.
ip sla ethernet-monitor schedule operation-number schedule-period seconds [frequency [seconds]] [start-time {after hh:mm:ss | hh:mm[:ss] [month day | day month] | now | pending}]
no ip sla ethernet-monitor schedule operation-number
Syntax Description
Command Default
The IP SLAs auto Ethernet operation is placed in a pending state (that is, the operation is enabled but is not actively collecting information).
Command Modes
Global configuration
Command History
Usage Guidelines
After you schedule an IP SLAs auto Ethernet operation with the ip sla ethernet-monitor schedule command, you should not change the configuration of the operation until the operation has finished collecting information. To change the configuration of the operation, use the no ip sla ethernet-monitor schedule operation-number command in global configuration mode and then enter the new configuration information.
To display the current configuration settings of an IP SLAs auto Ethernet operation, use the show ip sla ethernet-monitor configuration command in user EXEC or privileged EXEC mode.
Examples
The following example shows how to configure operation parameters, proactive threshold monitoring, and scheduling options using an IP SLAs auto Ethernet operation. In this example, operation 10 is configured to automatically create IP SLAs Ethernet ping operations for all the discovered maintenance endpoints in the domain named testdomain and VLAN identification number 34. As specified by the proactive threshold monitoring configuration, when three consecutive connection loss events occur, a Simple Network Management Protocol (SNMP) trap notification should be sent. The schedule period for operation 10 is 60 seconds, and the operation is scheduled to start immediately.
ip sla ethernet-monitor 10type echo domain testdomain vlan 34!ip sla ethernet-monitor reaction-configuration 10 react connectionLoss threshold-type consecutive 3 action-type trapOnly!ip sla ethernet-monitor schedule 10 schedule-period 60 start-time nowRelated Commands
request-data-size (Ethernet)
To set the padding size for the data frame of a Cisco IOS IP Service Level Agreements (SLAs) Ethernet operation, use the request-data-size (Ethernet) command in the appropriate submode of IP SLA configuration or auto IP SLA MPLS configuration mode. To return to the default value, use the no form of this command.
request-data-size bytes
no request-data-size
Syntax Description
bytes
Padding size (in bytes) for the data frame of the operation. Range is 0 to the maximum of the protocol.
Defaults
The default padding size will vary depending on the type of IP SLAs operation you are configuring. See the CISCO-RTTMON-MIB MIB documentation for more details.
Command Modes
IP SLA Configuration
Ethernet echo (config-ip-sla-ethernet-echo)
Ethernet jitter (config-ip-sla-ethernet-jitter)IP SLA Auto Ethernet Configuration
Ethernet parameters configuration (config-ip-sla-ethernet-params)
Command History
Usage Guidelines
You must configure the type of Ethernet operation (such as Ethernet ping) before you can configure any of the other parameters of the operation.
Examples
The following example shows how to set the padding size to 40 bytes for IP SLAs Ethernet ping operation 3:
ip sla 3ethernet echo mpid 23 domain testdomain vlan 34request-data-size 40!ip sla schedule 3 life forever start-time nowRelated Commands
show ip sla ethernet-monitor configuration
To display configuration settings for IP Service Level Agreements (SLAs) auto Ethernet operations, use the show ip sla ethernet-monitor configuration command in user EXEC or privileged EXEC mode.
show ip sla ethernet-monitor configuration [operation-number]
Syntax Description
operation-number
(Optional) Number of the auto Ethernet operation for which the details will be displayed.
Command Modes
User EXEC
Privileged EXECCommand History
Usage Guidelines
If the identification number of an auto Ethernet operation is not specified, configuration values for all the configured auto Ethernet operations will be displayed.
Examples
The following is sample output from the show ip sla ethernet-monitor configuration command:
Router# show ip sla ethernet-monitor configuration 1Entry Number : 1Modification time : *00:47:46.703 GMT Thu Jan 11 2007Operation Type : echoDomain Name : aVLAN ID : 11Excluded MPIDs :Owner :Tag :Timeout(ms) : 5000Threshold(ms) : 5000Frequency(sec) : 60Operations List : EmptySchedule Period(sec): 0Request size : 0CoS : 0Start Time : Pending triggerSNMP RowStatus : notInServiceReaction Configs :Reaction Index : 1Reaction : RTTThreshold Type : NeverThreshold Rising : 300Threshold Falling : 200Threshold CountX : 5Threshold CountY : 5Action Type : NoneTable 2 describes the significant fields shown in the display.
Related Commands
type echo domain
To configure a Cisco IOS IP Service Level Agreements (SLAs) auto Ethernet operation to create Ethernet ping operations, use the type echo domain command in IP SLA Ethernet monitor configuration mode.
type echo domain domain-name vlan vlan-id [exclude-mpids mp-ids]
Syntax Description
Command Default
Ethernet ping operations are not configured.
Command Modes
IP SLA Ethernet monitor
Command History
Usage Guidelines
Note When an IP SLAs Ethernet ping operation is created by an auto Ethernet operation, an operation number (identification number) is automatically assigned to the ping operation. The operation numbering starts at 100001.
You must configure the type of auto Ethernet operation (such as Ethernet ping) before you can configure any of the other parameters of the operation.
To change the operation type of an existing IP SLAs operation, you must first delete the IP SLAs operation (using the no ip sla ethernet-monitor global configuration command) and then reconfigure the operation with the new operation type.
Examples
The following example shows how to configure operation parameters, proactive threshold monitoring, and scheduling options using an IP SLAs auto Ethernet operation. In this example, operation 10 is configured to automatically create IP SLAs Ethernet ping operations for all the discovered maintenance endpoints in the domain named testdomain and VLAN identification number 34. As specified by the proactive threshold monitoring configuration, when three consecutive connection loss events occur, a Simple Network Management Protocol (SNMP) trap notification should be sent. The schedule period for operation 10 is 60 seconds, and the operation is scheduled to start immediately.
ip sla ethernet-monitor 10type echo domain testdomain vlan 34!ip sla ethernet-monitor reaction-configuration 10 react connectionLoss threshold-type consecutive 3 action-type trapOnly!ip sla ethernet-monitor schedule 10 schedule-period 60 start-time nowRelated Commands
Command Descriptionip sla ethernet-monitor
Begins configuration for an IP SLAs auto Ethernet operation and enters Ethernet monitor configuration mode.
type jitter domain
To configure a Cisco IOS IP Service Level Agreements (SLAs) auto Ethernet operation to create Ethernet jitter operations, use the type jitter domain command in IP SLA Ethernet monitor configuration mode.
type jitter domain domain-name vlan vlan-id [exclude-mpids mp-ids] [interval interframe-interval] [num-frames frames-number]
Syntax Description
Command Default
Ethernet jitter operations are not configured.
Command Modes
IP SLA Ethernet monitor
Command History
Usage Guidelines
Note When an IP SLAs Ethernet jitter operation is created by an auto Ethernet operation, an operation number (identification number) is automatically assigned to the jitter operation. The operation numbering starts at 100001.
You must configure the type of auto Ethernet operation (such as Ethernet jitter) before you can configure any of the other parameters of the operation.
To change the operation type of an existing IP SLAs operation, you must first delete the IP SLAs operation (using the no ip sla ethernet-monitor global configuration command) and then reconfigure the operation with the new operation type.
Examples
The following example shows how to configure operation parameters, proactive threshold monitoring, and scheduling options using an IP SLAs auto Ethernet operation. In this example, operation 20 is configured to automatically create IP SLAs Ethernet jitter operations for all the discovered maintenance endpoints in the domain named testdomain and VLAN identification number 34. For each Ethernet jitter operation, the interframe interval is set to 20 ms and the number of frames to be sent is 30. As specified by the proactive threshold monitoring configuration, when three consecutive connection loss events occur, a Simple Network Management Protocol (SNMP) trap notification should be sent. The schedule period for operation 20 is 60 seconds, and the operation is scheduled to start immediately.
ip sla ethernet-monitor 20type jitter domain testdomain vlan 34 interval 20 num-frames 30!ip sla ethernet-monitor reaction-configuration 20 react connectionLoss threshold-type consecutive 3 action-type trapOnly!ip sla ethernet-monitor schedule 20 schedule-period 60 start-time nowRelated Commands
Command Descriptionip sla ethernet-monitor
Begins configuration for an IP SLAs auto Ethernet operation and enters Ethernet monitor configuration mode.
Feature Information for the IP SLAs Ethernet Operation
Table 3 lists the release history for this feature.
Not all commands may be available in your Cisco IOS software release. For release information about a specific command, see the command reference documentation.
Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which Cisco IOS and Catalyst OS software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Note Table 3 lists only the Cisco IOS software release that introduced support for a given feature in a given Cisco IOS software release train. Unless noted otherwise, subsequent releases of that Cisco IOS software release train also support that feature.
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
© 2007 Cisco Systems, Inc. All rights reserved.