check_cisco_uc_perf

README

check_cisco_uc_perf

check_cisco_uc_perf is a Nagios plugin to monitor the performance of Cisco Unified Communications Servers

file: check_cisco_ucm_perf.go Version 0.8 (21.04.2022)

check_cisco_ucm_perf is a Nagios plugin made by Herwig Grimm (herwig.grimm at aon.at) to monitor the performance Cisco Unified Communications Manager CUCM.

I have used the Google Go programming language because of no need to install any libraries.

The plugin uses the Cisco PerfmonPort SOAP Service via HTTPS to do a wide variety of checks.

This nagios plugin is free software, and comes with ABSOLUTELY NO WARRANTY. It may be used, redistributed and/or modified under the terms of the GNU General Public Licence (see http://www.fsf.org/licensing/licenses/gpl.txt).

tested with:

	Cisco Unified Communications Manager CUCM version 10.5.1.11901-1
	Cisco Unified Communications Manager CUCM version 9.1.2.11900-12
	Cisco Unified Communications Manager CUCM version 8.6.2.22900-9
	Cisco Unified Communications Manager CUCM version 14

see also:

	Cisco Unified Communications Manager XML Developers Guide, Release 9.0(1)
	http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cucm/devguide/9_0_1/xmldev-901.html

changelog:

	Version 0.1 (15.05.2014) initial release
	Version 0.2 (20.05.2014) object caching added. new func loadStruct and saveStruct
	Version 0.3 (27.02.2015) General Public Licence added
	Version 0.3.1 (27.02.2015) new flag -m maximum cache age in seconds and flag -a and flag -A Cisco AXL API version of AXL XML Namespace
	Version 0.3.2 (27.02.2015) changed flag -H usage description
	...
	Version 0.8 (21.04.2021) XML data parsing largely reworked. New argument -C to define the cache file path and new argument -L to define the log filename.

usage:

-A string
	Cisco AXL API version of AXL XML Namespace (default "9.0")
-C string
	Cache file path (default "/tmp/check_cisco_uc_perf/")
-H string
	CUCM server IP address
-L string
	Log file path and name (default "/var/log/check_cisco_uc_perf.log")
-M string
	Comma separated list of nodes (IP addresses)
-N string
	Node IP address
-V		print plugin version
-c string
	Critical threshold or threshold range (default "1")
-d int
	print debug, level: 1 errors only, 2 warnings and 3 informational messages
-l		print PerfmonListCounter
-m int
	maximum cache age in seconds (default 180)
-n string
	Counter name
-o string
	Perfmon object with optional tailing instance names in parenthesis (default "Memory")
-p string
	password
-u string
	username
-w string
	Warning threshold or threshold range (default "1")