[rancid] Re: Monitoring BGP in Rancid

john heasley heas at shrubbery.net
Sun Sep 6 23:48:23 UTC 2009


Sun, Sep 06, 2009 at 04:06:45PM -0400, Jon Lewis:
> On Fri, 4 Sep 2009, mathiruban wrote:
> 
> > Dear Team,
> >
> > Is it possible to monitor the BGP status in links using Rancid looking glass?
> > If BGP is down, can I get the email notification?
> 
> I don't see why you couldn't add a show ip bg sum to the commands 
> run...but the problem I'd see with doing that in rancid is that if you're 
> talking about BGP (full routes, peering) with external AS's, the 
> number of prefixes received is likely to be in constant flux, causing a 
> diff every time rancid runs.
> 
> ----------------------------------------------------------------------
>   Jon Lewis                   |  I route
>   Senior Network Engineer     |  therefore you are
>   Atlantic Net                |
> _________ http://www.lewis.org/~jlewis/pgp for PGP public key_________
> _______________________________________________
> Rancid-discuss mailing list
> Rancid-discuss at shrubbery.net
> http://www.shrubbery.net/mailman/listinfo.cgi/rancid-discuss

attached is used for cisco.  you'll have to make your own adjustments to
rancid-fe and whatever else within the script.
-------------- next part --------------
#! /usr/bin/perl
##
## $Id: cbgp,v 1.4 2005/05/16 07:14:05 heas Exp $
##
## Copyright (C) 1997-2004 by Terrapin Communications, Inc.
## All rights reserved.
##
## This software may be freely copied, modified and redistributed
## without fee for non-commerical purposes provided that this license
## remains intact and unmodified with any RANCID distribution.
##
## There is no warranty or other guarantee of fitness of this software.
## It is provided solely "as is".  The author(s) disclaim(s) all
## responsibility and liability with respect to this software's usage
## or its effect upon hardware, computer systems, other software, or
## anything else.
##
## Except where noted otherwise, rancid was written by and is maintained by
## Henry Kilmer, John Heasley, Andrew Partan, Pete Whiting, and Austin Schutz.
##
#
#  RANCID - Really Awesome New Cisco confIg Differ
#
# usage: rancid [-d] [-l] [-f filename | $host]
#
use Getopt::Std;
getopts('dfl');
$log = $opt_l;
$debug = $opt_d;
$file = $opt_f;
$host = $ARGV[0];
$clean_run = 0;
$timeo = 90;			# clogin timeout in seconds

my(%filter_pwds);		# password filtering mode

# This routine is used to print out the router configuration
sub ProcessHistory {
    my($new_hist_tag,$new_command,$command_string, at string)=(@_);
    if((($new_hist_tag ne $hist_tag) || ($new_command ne $command))
       && defined %history) {
	print eval "$command \%history";
	undef %history;
    }
    if (($new_hist_tag) && ($new_command) && ($command_string)) {
	if ($history{$command_string}) {
	    $history{$command_string} = "$history{$command_string}@string";
	} else {
	    $history{$command_string} = "@string";
	}
    } elsif (($new_hist_tag) && ($new_command)) {
	$history{++$#history} = "@string";
    } else {
	print "@string";
    }
    $hist_tag = $new_hist_tag;
    $command = $new_command;
    1;
}

sub numerically { $a <=> $b; }

# This is a sort routing that will sort numerically on the
# keys of a hash as if it were a normal array.
sub keynsort {
    local(%lines)=@_;
    local($i) = 0;
    local(@sorted_lines);
    foreach $key (sort numerically keys(%lines)) {
	$sorted_lines[$i] = $lines{$key};
	$i++;
    }
    @sorted_lines;
}

# This is a sort routing that will sort on the
# keys of a hash as if it were a normal array.
sub keysort {
    local(%lines)=@_;
    local($i) = 0;
    local(@sorted_lines);
    foreach $key (sort keys(%lines)) {
	$sorted_lines[$i] = $lines{$key};
	$i++;
    }
    @sorted_lines;
}

# This is a sort routing that will sort on the
# values of a hash as if it were a normal array.
sub valsort{
    local(%lines)=@_;
    local($i) = 0;
    local(@sorted_lines);
    foreach $key (sort values %lines) {
	$sorted_lines[$i] = $key;
	$i++;
    }
    @sorted_lines;
}

# This is a numerical sort routing (ascending).
sub numsort {
    local(%lines)=@_;
    local($i) = 0;
    local(@sorted_lines);
    foreach $num (sort {$a <=> $b} keys %lines) {
	$sorted_lines[$i] = $lines{$num};
	$i++;
    }
    @sorted_lines;
}

# This is a sort routine that will sort on the
# ip address when the ip address is anywhere in
# the strings.
sub ipsort {
    local(%lines)=@_;
    local($i) = 0;
    local(@sorted_lines);
    foreach $addr (sort sortbyipaddr keys %lines) {
	$sorted_lines[$i] = $lines{$addr};
	$i++;
    }
    @sorted_lines;
}

# These two routines will sort based upon IP addresses
sub ipaddrval {
    my(@a) = ($_[0] =~ m#^(\d+)\.(\d+)\.(\d+)\.(\d+)$#);
    $a[3]+256*($a[2]+256*($a[1]+256*$a[0]));
}
sub sortbyipaddr {
    &ipaddrval($a) <=> &ipaddrval($b);
}

# This routine parses "show ip bgp summary"
sub ShowBgpSum {
    my($hdrout) = 0;

    print STDERR "    In ShowBgpSum: $_" if ($debug);

    $hdr = sprintf("%-20s%10s\t%s\n", "Neighbor", "AS", "State");

    while (<INPUT>) {
	tr/\015//d;
	last if(/^$prompt/);
	next if(/^(\s*|\s*$cmd\s*)$/);
	return(1) if /(Invalid input detected|Type help or )/;
	# the pager can not be disabled per-session on the PIX
	s/^<-+ More -+>\s*//;

	if (/^\s*(\d+\.\d+\.\d+\.\d+)\s*\d\s*(\d+)\s*.*\s+(\d+)$/) {
	    $ip = $1; $as = $2; $state = "up";
	    if (! $hdrout) {
		$hdrout++;
		ProcessHistory("","","","$hdr");
	    }
	    $line = sprintf("%-20s%10s\t%s\n", $ip, $as, $state);
	    ProcessHistory("BGP","ipsort","$1","$line") && next;
	}
	if (/^\s*(\d+\.\d+\.\d+\.\d+)\s*\d\s*(\d+)\s*.*\s+(\S+)\s*$/) {
	    $ip = $1; $as = $2; $state = "down";
	    if (! $hdrout) {
		$hdrout++;
		ProcessHistory("","","","$hdr");
	    }
	    $line = sprintf("%-20s%10s\t%s\n", $ip, $as, $state);
	    ProcessHistory("BGP","ipsort","$1","$line") && next;
	}

    }
    ProcessHistory("","","","!\n");
    return(0);
}

# This routine parses "show ip bgp summary"
sub ShowBgp6Sum {
    my($hdrout) = 0;

    print STDERR "    In ShowBgp6Sum: $_" if ($debug);

    $hdr = sprintf("%-40s%10s\t%s\n", "Neighbor", "AS", "State");

    while (<INPUT>) {
	tr/\015//d;
	last if(/^$prompt/);
	next if(/^(\s*|\s*$cmd\s*)$/);
	return(1) if /(Invalid input detected|Type help or )/;
	# the pager can not be disabled per-session on the PIX
	s/^<-+ More -+>\s*//;

	# v6_ip \n
	# ... AS ... (N_prefixes|Connect/etc)
	if (/^(\S+(:\S*)+)\s*$/) {
	    $ip = $1;
	    if (! $hdrout) {
		$hdrout++;
		ProcessHistory("","","","$hdr");
	    }
	    $_ = <INPUT>;
	    tr/\015//d;
	    if (/^\s+\d\s+(\d+)\s+.*\s+(\d+)$/) {
		$as = $1; $state = "up";
		$line = sprintf("%-40s%10s\t%s\n", $ip, $as, $state);
		ProcessHistory("BGP","numsort","$as","$line") && next;
	    }
	    /^\s+\d\s+(\d+)\s+.*\s+(\S+)\s*$/;
	    $as = $1; $state = "down";
	    $line = sprintf("%-40s%10s\t%s\n", $ip, $as, $state);
	    ProcessHistory("BGP","numsort","$as","$line");
	    next;
	}
	# v6_ip ... AS ... N_prefixes
	if (/^(\S+(:\S*)+)\s+\d\s+(\d+)\s+.*\s+(\d+)\s*$/) {
	    $ip = $1; $as = $3; $state = "up";
	    if (! $hdrout) {
		$hdrout++;
		ProcessHistory("","","","$hdr");
	    }
	    $line = sprintf("%-40s%10s\t%s\n", $ip, $as, $state);
	    ProcessHistory("BGP","numsort","$as","$line");
	    next;
	}
	# v6_ip ... AS ... Connect/OpenConfirm/etc
	if (/^(\S+(:\S?)+)\s+\d\s+(\d+)\s+.*\s+(\S+)\s*$/) {
	    $ip = $1; $as = $3; $state = "up";
	    if (! $hdrout) {
		$hdrout++;
		ProcessHistory("","","","$hdr");
	    }
	    $line = sprintf("%-40s%10s\t%s\n", $ip, $as, $state);
	    ProcessHistory("BGP","numsort","$as","$line");
	    next;
	}

	# may be an ipv4 peer addr
	# v6_ip ... AS ... N_prefixes
	if (/^\s*(\d+\.\d+\.\d+\.\d+)\s*\d\s*(\d+)\s*.*\s+(\d+)$/) {
	    $ip = $1; $as = $2; $state = "up";
	    if (! $hdrout) {
		$hdrout++;
		ProcessHistory("","","","$hdr");
	    }
	    $line = sprintf("%-40s%10s\t%s\n", $ip, $as, $state);
	    ProcessHistory("BGP","numsort","$as","$line") && next;
	}
	# v4_ip ... AS ... Connect/OpenConfirm/etc
	if (/^\s*(\d+\.\d+\.\d+\.\d+)\s*\d\s*(\d+)\s*.*\s+(\S+)$/) {
	    $ip = $1; $as = $2; $state = "down";
	    if (! $hdrout) {
		$hdrout++;
		ProcessHistory("","","","$hdr");
	    }
	    $line = sprintf("%-40s%10s\t%s\n", $ip, $as, $state);
	    ProcessHistory("BGP","numsort","$as","$line") && next;
	}
    }
    return(0);
}

# dummy function
sub DoNothing {print STDOUT;}

# Main
%commands=(
	'show ip bgp summary'			=> "ShowBgpSum",
	'show ipv6 bgp summary'			=> "ShowBgp6Sum",
	'show ip bgp ipv6 unicast summary'	=> "ShowBgp6Sum",
);
# keys() doesnt return things in the order entered and the order of the
# cmds is important (show version first and write term last). pita
@commands=(
	"show ip bgp summary",
	"show ipv6 bgp summary",
	"show ip bgp ipv6 unicast summary"
);
$cisco_cmds=join(";", at commands);
$cmds_regexp=join("|", at commands);

open(OUTPUT,">$host.new") || die "Can't open $host.new for writing: $!\n";
select(OUTPUT);
# make OUTPUT unbuffered if debugging
if ($debug) { $| = 1; }

if ($file) {
    print STDERR "opening file $host\n" if ($debug);
    print STDOUT "opening file $host\n" if ($log);
    open(INPUT,"<$host") || die "open failed for $host: $!\n";
} else {
    print STDERR "executing clogin -t $timeo -c\"$cisco_cmds\" $host\n" if ($debug);
    print STDOUT "executing clogin -t $timeo -c\"$cisco_cmds\" $host\n" if ($log);
    if (defined($ENV{NOPIPE})) {
	system "clogin -t $timeo -c \"$cisco_cmds\" $host </dev/null > $host.raw 2>&1" || die "clogin failed for $host: $!\n";
	open(INPUT, "< $host.raw") || die "clogin failed for $host: $!\n";
    } else {
	open(INPUT,"clogin -t $timeo -c \"$cisco_cmds\" $host </dev/null |") || die "clogin failed for $host: $!\n";
    }
}

# determine password filtering mode
if ($ENV{"FILTER_PWDS"} =~ /no/i) {
	$filter_pwds = 0;
} elsif ($ENV{"FILTER_PWDS"} =~ /all/i) {
	$filter_pwds = 2;
} else {
	$filter_pwds = 1;
}

ProcessHistory("","","","!RANCID-CONTENT-TYPE: cisco_bgp\n!\n");
#ProcessHistory("COMMENTS","keysort","B0","!\n");
#ProcessHistory("COMMENTS","keysort","D0","!\n");
#ProcessHistory("COMMENTS","keysort","F0","!\n");
#ProcessHistory("COMMENTS","keysort","G0","!\n");
TOP: while(<INPUT>) {
    tr/\015//d;
NEXT:if (/[>#]\s?exit$/) {
	$clean_run=1;
	last;
    }
    if (/^Error:/) {
	print STDOUT ("$host clogin error: $_");
	print STDERR ("$host clogin error: $_") if ($debug);
	$clean_run=0;
	last;
    }
    while (/#\s*($cmds_regexp)\s*$/) {
	$cmd = $1;
	if (!defined($prompt)) {
	    $prompt = ($_ =~ /^([^#]+#)/)[0];
	    $prompt =~ s/([][}{)(\\])/\\$1/g;
	    print STDERR ("PROMPT MATCH: $prompt\n") if ($debug);
	}
	print STDERR ("HIT COMMAND:$_") if ($debug);
	if (! defined($commands{$cmd})) {
	    print STDERR "$host: found unexpected command - \"$cmd\"\n";
	    $clean_run = 0;
	    last TOP;
	}
	$rval = &{$commands{$cmd}};
	delete($commands{$cmd});
	if ($rval == -1) {
	    $clean_run = 0;
	    last TOP;
	}
	goto NEXT;
    }
}
print STDOUT "Done $logincmd: $_\n" if ($log);
# Flush History
ProcessHistory("","","","");
# Cleanup
close(INPUT);
close(OUTPUT);

if (defined($ENV{NOPIPE})) {
    unlink("$host.raw") if (! $debug);
}

# check for completeness
if (scalar(%commands) || !$clean_run) {
    if (scalar(%commands)) {
	printf(STDOUT "$host: missed cmd(s): %s\n", join(',', keys(%commands)));
	printf(STDERR "$host: missed cmd(s): %s\n", join(',', keys(%commands))) if ($debug);
    }
    if (!$clean_run) {
	print STDOUT "$host: End of run not found\n";
	print STDERR "$host: End of run not found\n" if ($debug);
	system("/usr/bin/tail -1 $host.new");
    }
    unlink "$host.new" if (! $debug);
}


More information about the Rancid-discuss mailing list