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

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

Moderators: Developers, Moderators

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

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

Post by 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.
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
Basic Jitter
Basic Jitter
saa_jitter.png (58.26 KiB) Viewed 166799 times
Jitter with standard deviation
Jitter with standard deviation
saa_jitter_dispersion.png (77.69 KiB) Viewed 166799 times
cacti_data_query_cisco_ip_sla_statistics.xml
Import using cacti import/export template interface
(191.98 KiB) Downloaded 15692 times
cisco_saa.xml
Copy to {cacti_root}/resource/snmp_queries/
(22.47 KiB) Downloaded 12750 times
Last edited by hwon on Fri May 04, 2007 4:08 pm, edited 3 times in total.
hwon
Posts: 34
Joined: Thu Mar 02, 2006 4:11 pm
Location: TX

Importing mibs

Post by 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.
Attachments
Without mibs
Without mibs
without.PNG (8.48 KiB) Viewed 170042 times
With mibs
With mibs
withmibs.PNG (11.02 KiB) Viewed 170042 times
mibs.zip
Extract to your mibs directory
(53.75 KiB) Downloaded 7715 times
Frizz
Cacti User
Posts: 80
Joined: Sat Mar 05, 2005 5:07 pm
Location: Herne Germany

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

Post by Frizz »

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

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

Post by hwon »

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

Sample Basic & DNS statistics

Post by 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
Attachments
DNS statistics
DNS statistics
dns.png (28.73 KiB) Viewed 169983 times
DHCP statistics
DHCP statistics
dhcp.png (23.63 KiB) Viewed 169983 times
TCP Connect statistics
TCP Connect statistics
tcpconnect.png (34.28 KiB) Viewed 169983 times
Last edited by hwon on Wed Feb 07, 2007 11:32 am, edited 1 time in total.
hwon
Posts: 34
Joined: Thu Mar 02, 2006 4:11 pm
Location: TX

Sample HTTP statistics

Post by 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
Attachments
HTTP statistics
HTTP statistics
http.png (45.6 KiB) Viewed 169983 times
hwon
Posts: 34
Joined: Thu Mar 02, 2006 4:11 pm
Location: TX

Sample Jitter & Jitter/Error statistics

Post by 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
Attachments
Jitter statistics
Jitter statistics
jitter.png (40.52 KiB) Viewed 169508 times
Jitter/Error statistics
Jitter/Error statistics
jitter-error.png (57.55 KiB) Viewed 169508 times
Last edited by hwon on Mon Feb 19, 2007 5:01 pm, edited 1 time in total.
hwon
Posts: 34
Joined: Thu Mar 02, 2006 4:11 pm
Location: TX

Sample VoIP Scoring

Post by 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
Attachments
VoIP scoring
VoIP scoring
voip.png (53.24 KiB) Viewed 169977 times
hwon
Posts: 34
Joined: Thu Mar 02, 2006 4:11 pm
Location: TX

Tips using IP SLA with Cacti

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

Error importing file for ip sla

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

Upgrade to 0.8.6j

Post by hwon »

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

Post by 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:
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

Post by gonz0 »

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

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

Post by 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!
Post Reply

Who is online

Users browsing this forum: No registered users and 1 guest