[XML] Cisco IP SLA templates (AKA RTR & SAA)

[hwon]

[XML] Cisco IP SLA templates (AKA RTR & SAA)

This is for graphing Cisco IP SLA Probes. For those of you who is not familiar with Cisco IP SLA, it is a probe s/w loaded on Cisco IOS based equipments that you can use to measure round trip times of various protocols/applications on the network. If you have 12.x your router/switch probably have IP SLA capability already present on the equipment, and you just need to create a probe entry. Cisco IP SLA has grown since its introduction in 11.x code (Yup, there are some 11.x code which can do IP SLA, back then called RTR), now it has about 15 or so probe types. Included is HTTP, DNS, ICMP, UDP, Jitter, FTP, DHCP, to name the few. Some you can run with single equipment, some you have to run with two equipments in a client server mode to get more accurate reading on the network health. Check out Emmanuel Tychon's page on more information on Cisco IP SLA:

http://www.etychon.com


I have created a new thread as I do not have access to user ID of original thread. But you can refer to the old thread for historical information on the template:

http://forums.cacti.net/about4136.html

I've added probe specific graph templates since the last time I've updated the templates. Here is the list of graph templates:

Basic - Use this for anything that does not fit in to specific templates (dhcp, tcp connect, etc.)
DNS - shows target DNS query
FTP - shows file size and URL
HTTP - break down of DNS resolve, TCP hand shake, and HTTP, and also shows page size, URL, and HTTP status code
Jitter - Shows source <-> destination positive/negative jitter
Jitter/Error - Shows RTT average value with max min grey band
VoIP Scoring - Shows MOS scoring and VoIP codec

Aside from jitter and http template, the main difference among other templates are the tag lines, which you can take advantage of by importing IP SLA mibs. I will post instructions shortly on how to import the mibs.


5/4/2007
Thanks to Steve W. we have additional jitter template that utilizes standard deviation (SD) instead of simple min/ave/max value. The benefit of graph based on the SD is that outlying data will not pull the average and maximum value out as on the min/ave/max based graph, thus normalizing the graph.

[hwon]

To get most out of the updated graph templates, I suggest importing the mibs for IP SLA. Attached is two mibs that needs to be copied to /mibs directory (On my Ubuntu linux, the location was /usr/share/snmp/mibs/). Once copied, add following lines in snmp.conf (might need to create the file if it does not exist, my snmp.conf resides in /usr/share/snmp/):

mibs +CISCO-SMI
mibs +CISCO-RTTMON-MIB

Once mibs and xml files are imported/copied go to 'New Graphs', Select your IP SLA configured router, Edit this host, Add Data Query, select 'Cisco - IP SLA Statistics', click on add. Now you can click on 'Create Graphs for this Host', and you should see a screen like below with informative description of the probe instead of just numbers. Also, the description will be carried on the actual graph tag entries.

[Frizz]

[hwon]

[hwon]

Sample Basic & DNS statistics

Basic statistics
Use this template/probe to get response time for DHCP, PING (ICMP), TCP Connect and any other probes without matching graph template

DNS statistics
Use it to get response time for DNS probe. Sample config to resolve www.yahoo.com using 208.67.222.222 DNS server every 5 minutes with 100ms threshold:

ip sla monitor 232
type dns target-addr www.yahoo.com name-server 208.67.222.222
frequency 300
threshold 100
ip sla monitor schedule 232 life forever start-time now

[hwon]

Sample HTTP statistics

Use this template/probe to get response time breakdown of DNS lookup, TCP handshake, and HTTP get. Sample config to get home page of www.cisco.com without caching, resolve using 208.67.222.222 DNS server every 5 minutes with 500ms threshold:

ip sla monitor 456
type http operation get url http://www.cisco.com name-server 208.67.222.222 cache disable
threshold 500
frequency 300
ip sla monitor schedule 456 life forever start-time now

[hwon]

Sample Jitter & Jitter/Error statistics

Use this template/probe to get detailed response time and jitter statistics on the network. To make this work, you need to have other router running 'ip sla responder'. Best probe to measure overall network health and especially useful if you want to measure the network health for multimedia application, VoIP, and Video. Also, If you run this probe on WAN edge routers, you can compare SLA you get from the Cacti to the ones service provider presents. On the Jitter template the green line is statically setup at 30ms and -30ms as that seems to be the maximum recommended jitter value for VoIP application. Obviously my sample network isn't qualified for VoIP transmission based on the charts.

Sample config to get UDP Jitter statistics between local router and 10.0.0.2 (remote router running 'ip sla responder') every 5 minutes on port 10000.

ip sla monitor 1
type jitter dest-ipaddr 10.0.0.2 dest-port 10000
frequency 300
ip sla monitor schedule 1 life forever start-time now

[hwon]

Sample VoIP Scoring

This is really a subset of Jitter & Jitter/Error template/probe. You need to be running jitter probe with codec option. As a result you get MOS and ICPIF scoring with descriptions. Sample config to get VoIP scoring and UDP Jitter statistics between local router and 10.0.0.2 (remote router running 'ip sla responder') every 5 minutes on port 10004 using g729a codec with 160ms threshold:

ip sla monitor 3452
type jitter dest-ipaddr 10.0.0.2 dest-port 10004 codec g729a
threshold 160
frequency 300
ip sla monitor schedule 3452 life forever start-time now

[hwon]

Lastly, just some tips on setting up Cisco IP SLA with Cacti:

- Setup NTP on the equipments
- Use SNMPv2c instead of SNMPv1 if possible
- Setup threshold that makes sense, the default is 5000ms
- Use tag command to enter descriptive information of the IP SLA entry
- When using HTTP & FTP probe, use common sense on the size of the test files
- If QoS is enabled for VoIP traffic on the network, setup the VoIP probe to take advantage of the QoS

[arovira]

Hi, try to import the template an I am getting this error:

Error: XML: Hash version does not exist.


Thanks
This is the version of my cacti:

Cacti Version 0.8.6i
Plugin Architecture 1.0
Poller Type Cactid v0.8.6i
Server Info Linux 2.6.9-42.0.3.ELsmp
Web Server Apache/2.0.52 (CentOS)
PHP Version 4.3.9
PHP Extensions yp, xml, wddx, tokenizer, sysvshm, sysvsem, standard, sockets, shmop, session, pspell, posix, pcre, overload, mime_magic, iconv, gmp, gettext, ftp, exif, dio, dbx, dba, curl, ctype, calendar, bz2, bcmath, zlib, openssl, apache2handler, gd, mysql, snmp, eAccelerator
MySQL Version 4.1.20
RRDTool Version 1.2.15
SNMP Version 5.1.2

[hwon]

The template was exported from 0.8.6j. You will need to upgrade Cacti to 0.8.6j to import it.

[tl1997]

When I try to import cact_data_query_cisco_ip_sla_statistics_176.xml I get:

Fatal error: Maximum execution time of 60 seconds exceeded in /usr/local/share/cacti/lib/import.php on line 889

Originally this error was 30 seconds, but I increased the time in php.ini to 60 seconds. Anyone know why it times out? I tried both uploading the file and pasting it into the box, neither worked.

My config:

[gonz0]

Have a little problem:

I have added tcpConnect RTR

[ElGribbo]

Hello,

Awesome templates, this was exactly what I needed for a project this week.

One quick question though. I saw in the older thread, I believe it was Frizz was getting zero values for RTT AVE even though everything else was working fine. I am having the same issue.

Running version 0.8.6j. Everything has values except RTT AVE.

Would you happen to have any thoughts on this?

[ElGribbo]

Must have been a bug or something. Upgraded to a 12.3 IOS from a 12.2 and I now have RTT AVE values!

Thanks for your work on these!