configuring voip call setup monitoring - cisco.com · configuring voip call setup monitoring...

Configuring VoIP Call Setup Monitoring

The Cisco IOS IP Service Level Agreements (SLAs) VoIP Call Setup (Post-Dial Delay) Monitoring featureprovides the ability to measure your network’s response time for setting up a Voice over IP (VoIP) call overeither H.323 or Session Initiation Protocol (SIP).

• Finding Feature Information, page 1

• Prerequisites for VoIP Call Setup Monitoring, page 1

• Information About VoIP Call Setup Monitoring, page 2

• How to Configure VoIP Call Setup Monitoring, page 2

• Configuration Examples for VoIP Call Setup Monitoring, page 11

• Additional References, page 11

• Feature Information for VoIP Call Setup Monitoring, page 13

Finding Feature InformationYour software release may not support all the features documented in this module. For the latest caveats andfeature information, see Bug Search Tool and the release notes for your platform and software release. Tofind information about the features documented in this module, and to see a list of the releases in which eachfeature is supported, see the feature information table.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support.To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.

Prerequisites for VoIP Call Setup Monitoring• The Cisco IOS software image on the source and destination gateway must support the IP SLAs VoIPtest-call and IP SLAs VoIP Responder applications. To determine if your Cisco IOS software image isconfigured with these applications, use the show call application voicecommand in EXEC mode.

Router# show call application voice summaryNAME DESCRIPTION...

IP SLAs Configuration Guide, Cisco IOS Release 15M&T 1

https://tools.cisco.com/bugsearch/search

http://www.cisco.com/go/cfn

ipsla-testcall Basic app to place a simple callipsla-responder Basic app to respond to a simple call...TCL Script Version 2.0 supported.Call Treatment Action Application - Version 1.

The IP SLAs VoIP Responder application is different from the IP SLAs Responder, which is configuredusing a Cisco IOS command.

Note

Information About VoIP Call Setup Monitoring

IP SLAs VoIP Call Setup Monitoring Using H.323 or SIPThe Cisco IOS IP SLAs VoIP Call Setup Monitoring feature provides the ability to measure your network’sresponse time for setting up a VoIP call. Prior to configuring an IP SLAs VoIP call setup operation, you mustenable the IP SLAs VoIP test-call application on the originating gateway (source). With the IP SLAs VoIPtest-call application enabled, H.323 or Session Initiation Protocol (SIP) call messages can be sent to andreceived by the originating (source) and terminating (destination) gateways. The configuration for the IP SLAsVoIP call setup operation is essentially the same for both protocols.

The IP SLAs VoIP call setup operation can measure the total time from when an source gateway sends a callmessage, containing a call number, to when the sourcegateway receives a response from the destinationgateway indicating that either the called number rang or the called party answered the call. As with all CiscoIOS IP SLAs operations, you can configure the VoIP call setup operation to repeat at specified time intervals,for a specified number of repetitions, and over a specified duration of time.

If a gatekeeper (GK) or directory gatekeeper (DGK) is involved in the H.323 call signaling, additional messagesare sent and received between the source and destination gateways before the call message is actually sent.The additional time required for these messages is included in the IP SLAs VoIP call setup response timemeasurement. Likewise, if a proxy server or redirection server is involved in the SIP call signaling, anyadditional time required for messages to be sent and received prior to sending the call message, is includedin the VoIP call setup response time measurement.

A plain old telephone service (POTS) IP phone can be set up at the terminating gateway to respond to an IPSLAs VoIP call setup test call. As an alternative to an actual IP phone, you can enable the IP SLAs VoIPResponder application in the destination gateway. The IP SLAs VoIP Responder application will respond toincoming call setup messages from the source gateway using H.323 or SIP.

How to Configure VoIP Call Setup Monitoring

Configuring the Source Gateway

The required configuration for setting up the dial peer will vary slightly depending on whether you areusing H.323 or SIP.

Note

IP SLAs Configuration Guide, Cisco IOS Release 15M&T2

Configuring VoIP Call Setup MonitoringInformation About VoIP Call Setup Monitoring

SUMMARY STEPS

1. enable2. call application session start instance-name [application-name]3. configure terminal4. dial-peer voice tag voip5. destination-pattern [+] string [T]6. session target {ipv4: destination-address | dns:[$s$. | $d$. | $e$. | $u$.] host-name | enum: table-num |

loopback:rtp | ras | sip-server}7. session protocol sipv28. exit

DETAILED STEPS

PurposeCommand or Action

Enables privileged EXEC mode.enableStep 1

Example:

Router> enable

• Enter your password if prompted.

Starts a new session of the Cisco IOS IP SLAs VoIPtest-call application.

call application session start instance-name[application-name]

Example:

Router# call application session startipsla-testcall ipsla-testcall

Step 2

Enters global configuration mode.configure terminal

Example:

Router# configure terminal

Step 3

Defines a VoIP dial peer and enters dial-peerconfiguration mode.

dial-peer voice tag voip

Example:

Router(config)# dial-peer voice 6789 voip

Step 4

Specifies either the prefix or the full E.164 telephonenumber to be used for a dial peer.

destination-pattern [+] string [T]

Example:

Router(config-dial-peer)# destination-pattern 6789

Step 5

Designates a network-specific address to receive callsfrom the VoIP dial peer.

session target {ipv4: destination-address | dns:[$s$. | $d$.| $e$. | $u$.] host-name | enum: table-num | loopback:rtp| ras | sip-server}

Step 6


Configuring VoIP Call Setup MonitoringConfiguring the Source Gateway


Example:

Router(config-dial-peer)# session targetipv4:172.29.129.123

(Optional) Specifies SIP as the session protocol for theVoIP dial peer.

session protocol sipv2

Example:

Router(config-dial-peer)# session protocol sipv2

Step 7

Perform this step only if configuring a SIPcall.

Note

Exits dial-peer configuration mode and returns to globalconfiguration mode.

exit

Example:

Router(config-dial-peer)# exit

Step 8

Configuring a VoIP Call Setup Montioring Operation

SUMMARY STEPS

1. enable2. configure terminal3. ip sla operation-number4. voip delay post-dial [detect-point {alert-ringing | connect-ok}] destination tag5. history buckets-kept size6. history distributions-of-statistics-kept size7. history enhanced [interval seconds] [buckets number-of-buckets]8. history filter {none | all | overThreshold | failures}9. frequency seconds10. history hours-of-statistics-kept hours11. history lives-kept lives12. owner owner-id13. history statistics-distribution-interval milliseconds14. tag text15. threshold milliseconds16. timeout milliseconds17. end


Configuring VoIP Call Setup MonitoringConfiguring a VoIP Call Setup Montioring Operation

DETAILED STEPS



Example:

Router> enable



Example:


Step 2

Begins configuration for an IP SLAs operation and entersIP SLA configuration mode.

ip sla operation-number

Example:

Router(config)# ip sla 10

Step 3

Enters IP SLA VoIP configuration mode and configuresthe operation as a VoIP call setup (post-dial delay)

voip delay post-dial [detect-point {alert-ringing |connect-ok}] destination tag

Step 4

operation that will generate VoIP call setup response timemeasurements.Example:

Router(config-ip-sla)# voip delay post-dialdetect-point alert-ringing destination 6789

(Optional) Sets the number of history buckets that are keptduring the lifetime of an IP SLAs operation.

history buckets-kept size

Example:

Router(config-ip-sla-voip)# history buckets-kept25

Step 5

(Optional) Sets the number of statistics distributions keptper hop during an IP SLAs operation.

history distributions-of-statistics-kept size

Example:

Router(config-ip-sla-voip)# historydistributions-of-statistics-kept 5

Step 6

(Optional) Enables enhanced history gathering for an IPSLAs operation.

history enhanced [interval seconds] [bucketsnumber-of-buckets]

Example:

Router(config-ip-sla-voip)# history enhancedinterval 900 buckets 100

Step 7




(Optional) Defines the type of information kept in thehistory table for an IP SLAs operation.

history filter {none | all | overThreshold | failures}

Example:

Router(config-ip-sla-voip)# history filterfailures

Step 8

(Optional) Sets the rate at which a specified IP SLAsoperation repeats.

frequency seconds

Example:

Router(config-ip-sla-voip)# frequency 30

Step 9

(Optional) Sets the number of hours for which statisticsare maintained for an IP SLAs operation.

history hours-of-statistics-kept hours

Example:

Router(config-ip-sla-voip)# historyhours-of-statistics-kept 4

Step 10

(Optional) Sets the number of lives maintained in thehistory table for an IP SLAs operation.

history lives-kept lives

Example:

Router(config-ip-sla-voip)# history lives-kept5

Step 11

(Optional) Configures the Simple Network ManagementProtocol (SNMP) owner of an IP SLAs operation.

owner owner-id

Example:

Router(config-ip-sla-voip)# owner admin

Step 12

(Optional) Sets the time interval for each statisticsdistribution kept for an IP SLAs operation.

history statistics-distribution-interval milliseconds

Example:

Router(config-ip-sla-voip)# historystatistics-distribution-interval 10

Step 13

(Optional) Creates a user-specified identifier for an IPSLAs operation.

tag text

Example:

Router(config-ip-sla-voip)# tagTelnetPollServer1

Step 14

(Optional) Sets the upper threshold value for calculatingnetwork monitoring statistics created by an IP SLAsoperation.

threshold milliseconds

Example:

Router(config-ip-sla-voip)# threshold 10000

Step 15




(Optional) Sets the amount of time an IP SLAs operationwaits for a response from its request packet.

timeout milliseconds

Example:

Router(config-ip-sla-voip)# timeout 10000

Step 16

Exits to privileged EXEC mode.end

Example:

Router(config-ip-sla-voip)# exit

Step 17

Scheduling IP SLAs Operations

Before You Begin

• All IP Service Level Agreements (SLAs) operations to be scheduled must be already configured.

• The frequency of all operations scheduled in a multioperation group must be the same.

• The list of one or more operation ID numbers to be added to a multioperation group must be limited toa maximum of 125 characters in length, including commas (,).

SUMMARY STEPS

1. enable2. configure terminal3. Enter one of the following commands:

• 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]

• ip sla group schedule group-operation-number operation-id-numbers {schedule-periodschedule-period-range | schedule-together} [ageout seconds] frequency group-operation-frequency[life {forever | seconds}] [start-time {hh:mm [:ss] [month day | day month] | pending | now | afterhh:mm [:ss]}]

4. end5. show ip sla group schedule6. show ip sla configuration


Configuring VoIP Call Setup MonitoringScheduling IP SLAs Operations

DETAILED STEPS



Example:

Device> enable



Example:

Device# configure terminal

Step 2

Enter one of the following commands:Step 3 • Configures the scheduling parameters foran individual IP SLAs operation.

• 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]

• Specifies an IP SLAs operation groupnumber and the range of operationnumbers for a multioperation scheduler.

• ip sla group schedule group-operation-numberoperation-id-numbers {schedule-period schedule-period-range| schedule-together} [ageout seconds] frequencygroup-operation-frequency [life {forever | seconds}] [start-time{hh:mm [:ss] [month day | day month] | pending | now | afterhh:mm [:ss]}]

Example:

Device(config)# ip sla schedule 10 life forever start-timenow

Device(config)# ip sla group schedule 10 schedule-periodfrequency

Device(config)# ip sla group schedule 1 3,4,6-9 life foreverstart-time now

Device(config)# ip sla schedule 1 3,4,6-9 schedule-period50 frequency range 80-100

Exits global configuration mode and returns toprivileged EXEC mode.

end

Example:

Device(config)# end

Step 4

(Optional) Displays IP SLAs group scheduledetails.

show ip sla group schedule

Example:

Device# show ip sla group schedule

Step 5


Configuring VoIP Call Setup MonitoringScheduling IP SLAs Operations


(Optional) Displays IP SLAs configurationdetails.

show ip sla configuration

Example:

Device# show ip sla configuration

Step 6

Enabling the IP SLAs VoIP Responder Application on the Destination Gateway

The required configuration for setting up the dial peer will vary slightly depending on whether you areusing H.323 or SIP.

Note

SUMMARY STEPS

1. enable2. configure terminal3. dial-peer voice tag voip4. incoming called-number tag5. application application-name6. session protocol sipv27. end

DETAILED STEPS



Example:

Router> enable



Example:


Step 2


Configuring VoIP Call Setup MonitoringEnabling the IP SLAs VoIP Responder Application on the Destination Gateway


Defines a VoIP dial peer and enters dial-peer configurationmode.

dial-peer voice tag voip

Example:

Router(config)# dial-peer voice 6789 voip

Step 3

Specifies a digit string to be matched by an incoming call toassociate the call with a dial peer.

incoming called-number tag

Example:

Router(config-dial-peer)# incomingcalled-number 6789

Step 4

Enables the Cisco IOS IP SLAs VoIP Responder application(ipsla-responder) on the dial peer to respond to incomingcall setup messages.

application application-name

Example:

Router(config-dial-peer)# applicationipsla-responder

Step 5

(Optional) Specifies SIP as the session protocol for the VoIPdial peer.

session protocol sipv2

Example:

Router(config-dial-peer)# session protocolsipv2

Step 6

Perform this step only if configuring a SIPcall.

Note

Exits to privileged EXEC mode.end

Example:

Router(config-dial-peer)# exit

Step 7

Troubleshooting Tips• If the IP SLAs operation is not running and not generating statistics, add the verify-data command tothe configuration of the operation (while configuring in IP SLA configuration mode) to enable dataverification. When data verification is enabled, each operation response is checked for corruption. Usethe verify-data command with caution during normal operations because it generates unnecessaryoverhead.

• Use the debug ip sla trace and debug ip sla error commands to help troubleshoot issues with an IPSLAs operation.

What to Do NextTo add proactive threshold conditions and reactive triggering for generating traps (or for starting anotheroperation) to an IP SLAs operation, see the “Configuring Proactive Threshold Monitoring” section.


Configuring VoIP Call Setup MonitoringEnabling the IP SLAs VoIP Responder Application on the Destination Gateway

operation)

To display and interpret the results of an IP SLAs operation, use the show ip sla statistics command. Checkthe output for fields that correspond to criteria in your service level agreement to determine whether the servicemetrics are acceptable.

Configuration Examples for VoIP Call Setup Monitoring

Example VoIP Call Setup Configuration on the Source GatewayThe following example shows the configuration on the source (originating) gateway to start the IP SLAs VoIPtest-call application, set up the dial peer to route the test call, define the VoIP call setup operation, and schedulethe VoIP call setup operation. In this example, test-call messages are generated using the Session InitiationProtocol (SIP).

call application session start ipsla-testcall ipsla-testcallconfigure terminaldial-peer voice 6789 voipdestination-pattern 6789session target ipv4:172.29.129.123session protocol sipv2exitip sla 1voip delay post-dial detect-point alert-ringing destination 6789exitip sla schedule 1 start-time now life forever

Example VoIP Responder Application on Destination GatewayThe following example shows the configuration for setting up the dial peer and enabling the IP SLAs VoIPResponder application to respond to the IP SLAs VoIP call setup test call. In this example, test-call messagesare generated using the Session Initiation Protocol (SIP).

configure terminaldial-peer voice 6789 voipincoming called-number 6789application ipsla-respondersession protocol sipv2exit

Additional ReferencesRelated Documents

Document TitleRelated Topic

Cisco IOS Master Commands List, All ReleasesCisco IOS commands

Cisco IOS IP SLAs Command ReferenceCisco IOS IP SLAs commands


Configuring VoIP Call Setup MonitoringConfiguration Examples for VoIP Call Setup Monitoring

http://www.cisco.com/en/US/docs/ios/mcl/allreleasemcl/all_book.html

Document TitleRelated Topic

Cisco IOS IP SLAs Overview chapter of the CiscoIP SLAs Configuration Guide.

Cisco IOS IP SLAs: general information

Standards

TitleStandard

--No new or modified standards are supported by thisfeature, and support for existing standards has notbeen modified by this feature.

MIBs

MIBs LinkMIB

To locate and downloadMIBs for selected platforms,Cisco IOS releases, and feature sets, use Cisco MIBLocator found at the following URL:

http://www.cisco.com/go/mibs

CISCO-RTTMON-MIB

RFCs

TitleRFC

--No new or modified RFCs are supported by thisfeature, and support for existing RFCs has not beenmodified by this feature.

Technical Assistance

LinkDescription

http://www.cisco.com/cisco/web/support/index.htmlThe Cisco Support and Documentation websiteprovides online resources to download documentation,software, and tools. Use these resources to install andconfigure the software and to troubleshoot and resolvetechnical issues with Cisco products and technologies.Access to most tools on the Cisco Support andDocumentation website requires a Cisco.com user IDand password.


Configuring VoIP Call Setup MonitoringAdditional References

http://www.cisco.com/go/mibs

http://www.cisco.com/cisco/web/support/index.html

Feature Information for VoIP Call Setup MonitoringThe following table provides release information about the feature or features described in this module. Thistable lists only the software release that introduced support for a given feature in a given software releasetrain. Unless noted otherwise, subsequent releases of that software release train also support that feature.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support.To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.

Table 1: Feature Information for VoIP Call Setup Monitoring

Feature InformationReleasesFeature Name

The Cisco IOS IP SLAsVoice overIP (VoIP) call setup operationallows you to measure networkresponse time for setting up a VoIPcall.

12.3(14)TIP SLAs VoIP Call Setup (PostDial Delay) Monitoring


Configuring VoIP Call Setup MonitoringFeature Information for VoIP Call Setup Monitoring

http://www.cisco.com/go/cfn


Configuring VoIP Call Setup MonitoringFeature Information for VoIP Call Setup Monitoring