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

Templates, scripts for templates, scripts and requests for templates.

Moderators: Moderators, Developers

Post Reply
Author
Message
hwon
Posts: 31
Joined: Thu Mar 02, 2006 4:11 pm
Location: TX

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

#1 Post by hwon » Tue Feb 06, 2007 3:47 pm

[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.
Whilst max jitter is useful to show a worse case, it can be misleading if the SAA sample is based on 1000 packets which is standard for simulating voice i.e. a graph shows a 50ms jitter whereas 999 packets had a jitter of 3ms.

Cisco provide enough data in the MIB to calculate average jitter and standard deviation jitter, so I've created a new graph (in the same style) to do this.

The template package includes quite a few additions (altered data template, altered data query, new graph template, new CDEFs).
Attachments
saa_jitter.png
Basic Jitter
saa_jitter.png (58.26 KiB) Viewed 152032 times
saa_jitter_dispersion.png
Jitter with standard deviation
saa_jitter_dispersion.png (77.69 KiB) Viewed 152032 times
cacti_data_query_cisco_ip_sla_statistics.xml
Import using cacti import/export template interface
(191.98 KiB) Downloaded 15037 times
cisco_saa.xml
Copy to {cacti_root}/resource/snmp_queries/
(22.47 KiB) Downloaded 12238 times
Last edited by hwon on Fri May 04, 2007 4:08 pm, edited 3 times in total.

hwon
Posts: 31
Joined: Thu Mar 02, 2006 4:11 pm
Location: TX

Importing mibs

#2 Post by hwon » Tue Feb 06, 2007 3:55 pm

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.
Attachments
without.PNG
Without mibs
without.PNG (8.48 KiB) Viewed 155275 times
withmibs.PNG
With mibs
withmibs.PNG (11.02 KiB) Viewed 155275 times
mibs.zip
Extract to your mibs directory
(53.75 KiB) Downloaded 7330 times

Frizz
Cacti User
Posts: 80
Joined: Sat Mar 05, 2005 5:07 pm
Location: Herne Germany
Contact:

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

#3 Post by Frizz » Tue Feb 06, 2007 4:31 pm

hwon wrote:[XML] Cisco IP SLA templates (AKA RTR & SAA)
Hi HWON,
just a good point in time for this update, as I want to bring out our latency and jitter measurements from development to productive boxes.
I will give you an update to this later.
BTW, do you have think about the MOS (Mean Opinion Score), that is also measurable with IOS router?
Best regards
Frizz
Cacti 0.8.6j | Cactid 0.8.6j | RRDtool 1.2.23 |
SuSe 9.x | PHP 4.4.4 | MySQL 5.0.27 | IHS 2.0.42.1
Come and join the 3.CCC.eu
http://forums.cacti.net/viewtopic.php?t=27908

hwon
Posts: 31
Joined: Thu Mar 02, 2006 4:11 pm
Location: TX

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

#4 Post by hwon » Tue Feb 06, 2007 5:46 pm

Frizz wrote:BTW, do you have think about the MOS (Mean Opinion Score), that is also measurable with IOS router?
Howdy Frizz,

I know for sure MOS and ICPIF VoIP scoring is supported on 12.4 and some 12.3. But not sure of other 12.x versions.

hwon
Posts: 31
Joined: Thu Mar 02, 2006 4:11 pm
Location: TX

Sample Basic & DNS statistics

#5 Post by hwon » Wed Feb 07, 2007 11:25 am

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
Attachments
dns.png
DNS statistics
dns.png (28.73 KiB) Viewed 155216 times
dhcp.png
DHCP statistics
dhcp.png (23.63 KiB) Viewed 155216 times
tcpconnect.png
TCP Connect statistics
tcpconnect.png (34.28 KiB) Viewed 155216 times
Last edited by hwon on Wed Feb 07, 2007 11:32 am, edited 1 time in total.

hwon
Posts: 31
Joined: Thu Mar 02, 2006 4:11 pm
Location: TX

Sample HTTP statistics

#6 Post by hwon » Wed Feb 07, 2007 11:29 am

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
Attachments
http.png
HTTP statistics
http.png (45.6 KiB) Viewed 155216 times

hwon
Posts: 31
Joined: Thu Mar 02, 2006 4:11 pm
Location: TX

Sample Jitter & Jitter/Error statistics

#7 Post by hwon » Wed Feb 07, 2007 11:44 am

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
Attachments
jitter.png
Jitter statistics
jitter.png (40.52 KiB) Viewed 154741 times
jitter-error.png
Jitter/Error statistics
jitter-error.png (57.55 KiB) Viewed 154741 times
Last edited by hwon on Mon Feb 19, 2007 5:01 pm, edited 1 time in total.

hwon
Posts: 31
Joined: Thu Mar 02, 2006 4:11 pm
Location: TX

Sample VoIP Scoring

#8 Post by hwon » Wed Feb 07, 2007 11:51 am

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
Attachments
voip.png
VoIP scoring
voip.png (53.24 KiB) Viewed 155210 times

hwon
Posts: 31
Joined: Thu Mar 02, 2006 4:11 pm
Location: TX

Tips using IP SLA with Cacti

#9 Post by hwon » Thu Feb 08, 2007 1:18 pm

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
Posts: 2
Joined: Thu Feb 08, 2007 8:31 pm

Error importing file for ip sla

#10 Post by arovira » Fri Feb 09, 2007 8:41 am

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
Posts: 31
Joined: Thu Mar 02, 2006 4:11 pm
Location: TX

Upgrade to 0.8.6j

#11 Post by hwon » Fri Feb 09, 2007 11:47 am

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

tl1997
Posts: 19
Joined: Sat Feb 03, 2007 1:07 am
Location: Coral Gables, FL

#12 Post by tl1997 » Thu Mar 29, 2007 1:22 pm

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:
Cacti Version - 0.8.6j
Plugin Architecture - 1.1
Poller Type - CMD.php
Server Info - FreeBSD 6.1-RELEASE
Web Server - Apache/2.2.3 (FreeBSD) mod_ssl/2.2.3 OpenSSL/0.9.7e-p1 DAV/2 PHP/5.2.0 with Suhosin-Patch
PHP - 5.2.0
PHP Extensions - session, SPL, Reflection, date, libxml, apache2handler, mysql, pcre, standard, snmp, xml, sockets, gd, dba, rrdtool
MySQL - 5.0.27
RRDTool - 1.2.15
SNMP - 5.2.3
Plugins
  • Thresholds (thold - v0.3.0)
    PHP Network Weathermap (weathermap - v0.82)
    Network Tools (tools - v0.2)
    Device Tracking (mactrack - v0.0.1b)
    Network Discovery (discovery - v0.6)
    Host Info (hostinfo - v0.1)
    Simple Links page (links - v0.3)
    Create Aggregate Graphs (aggregate - v0.3)
    report it! (report it! - v0.3.2)

gonz0
Posts: 8
Joined: Sun Apr 01, 2007 11:28 am
Location: Poland - Warsaw

#13 Post by gonz0 » Mon Apr 02, 2007 4:24 am

Have a little problem:

I have added tcpConnect RTR
rtr 1
type tcpConnect dest-ipaddr 10.150.71.65 dest-port 443 source-ipaddr 172.130.85.1 control disable
tag SysCentr-tcp
rtr schedule 1 start-time now
ANd on the graph I don;t have all values to be shown:

SAA BASIC shows me:

Count: |query_rttMonLatestJitterOperNumOfRTT| <- what should I do with it ?

edit:

okey I know - there is no value for that snmp query.

ElGribbo
Posts: 5
Joined: Tue Apr 03, 2007 9:23 am
Location: Louisville, KY

RTT AVE

#14 Post by ElGribbo » Tue Apr 03, 2007 9:36 am

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
Posts: 5
Joined: Tue Apr 03, 2007 9:23 am
Location: Louisville, KY

#15 Post by ElGribbo » Tue Apr 03, 2007 12:19 pm

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!

Post Reply