MonitoringExchange
NagiosForge
NagiosWiki
Nagios Community Platform powered by NETWAYS

Plugin:check gtp v2.pl

Search  
From MonEx Wiki
Jump to: navigation, search

Contents

check_gtp_v2.pl

  • A nagios check plugin for GSM data networks based on 3GPP 29.060.

It can be used to check PDP contexts by resolving an APN, opening a GTP data session and download a file within the GTP tunnel. Addtional it will provide timestamps and troughput performance values.

get it on MonitoringExchange

check_gtp_v2.pl on Nagios Exchange

what do you need

  • Access to a GSM core network on Gn/Gp interface or a GGSN simulator is necessary to use this plugin. So maybe its best if you are a GSM operator ;-).
  • Nagios
  • check_gtp_v2.pl
  • multiplexer.pl
  • Gtp.pm
  • Net::Pcap::Reassemble

Help Output

nagios@nagioswiki.org:~/
$ ./check_gtp_v2.pl --help

check_gtp_v2.pl -H 
Options are:

    -H <string>               Hostname (optional / default: via apn)
    -I <string>               Interfacename 
    -p <integer>              UDP Port (optional / default: 2123)
    -P <integer>              TCP Port of the multiplex process (optional /default: 2123)
    
    -a <string>               APN
    -m <string>               MISDN
    -i <string>               IMSI
    -g <string>               GSN-Addresses comma seperated (optional / default InterfaceIpAddress)
                         
    -U <string>               Peer-ID (default: "")
    -S <string>               Password (default: "")

    -x <string>               additional hexcode to transmit (optional)
    -t <integer>,...          comma seperated list of seconds for each step before plugin will stop

    -s <integer>              seconds to sleep between CPCR and DPCQ (default: 1)
    
    -n <string>               comma seperated list of nameservers to query (optional) 

    -d <string>               download source 'hostname|ip|port|path'
    --dl-timeout <integer>    sets the download timeout in seconds (default: 10)
    --dl-not-found-warning    enable check result 'WARNING' if download results in '404 Not Found' and plugin result is not worse
    --dump-to-file <path>     write dump of downloaded data to file in <path> (string)
    --dump-to-screen          display dump of downloaded data on screen
    --dump-check              enable checking of content length
    --dump-warning            enable check result 'WARNING' if check of content length fails and plugin result is not worse
    --dump-length             enable display of content length in plugin output
    --dump-rate               enable display of download rate on plugin output
    --dump-rate-real          enable display of real download rate on plugin output

    -h, --help                display this help and exit
    -V, --version             output version information and exit
    
an example: check_gtp_v2.pl -I eth0 -a "blackberry.net" -m "+123456" -i "234103160051026"

Comments