philfry / check_tc4400

nagios check with perfdata for technicolor tc4400 cable modems

NAME

check_tc4400

SYNOPSIS

check_tc4400 <OPTIONS>

OPTIONS

• H,hostname HOSTNAME

  Hostname or ip address of your tc4400 modem.

• u,username username

  Username to authenticate with to the modem's webinterface.

• p,password password

  Password to authenticate with to the modem's webinterface.

• r,read filename

  Read data from file (usually for debugging purposes).

• i,ignore {docsis30|docsis31}

  Do not check thresholds for {docsis30|docsis31}. Collect perfdata though. Useful when your line performance is really bad but your modem works nonetheless, or you're connected both with docsis 3.0 and 3.1 but the modem only uses either of them.

• s,startle

  Startle the modem by sending an unauthorized dummy request prior to the "real" request for data. Use this workaround if your modem randomly times out with check_tc4400.

DESCRIPTION

This script connects to the TC4400 webinterface and parses the connection status page.

It warns or returns a critical state if:

- Connectivity State is not "OK"
- Boot State is not "OK"
- Configuration File is not "OK"
- Security is not "Enabled"
- downstream channel is not "Locked"
- downstream channel signal/noise ratio is below a predefined value
- downstream channel transmission level is odd
- upstream channel transmission level is odd

see 20180617_Pegelwerte.pdf for thresholds.

AUTHOR

Philippe Kueck <projects at unixadm dot org>

EXAMPLE

check_tc4400's Issues

Please Help! Works on Windows 10?

Hi, was wondering if this script runs on Windows 10 64-bit?
I have python installed for other homebrew applications.
I just installed new TC4400 cable modem.
Can access TC4400 via Chrome Browser at 192.168.100.1.
Cannot ping TC4400 at 192.168.100.1 via Windows 10 cmd.
Attempt to run script in Windows 10 cmd using -> check_tc4400.py -H 192.168.100.1 -u admin -p bEn2o#US9s
Nothing happens. Is it because I cannot ping my TC4400 modem which is on the other side of my router?

check_tc4400 doesn´t work reliable after update to latest version

Hi Phil,

after updating to the latest version i see that the check_tc4400 often reaches a timeout and doesn´t update reliable as before.
I was using the version with perl and updated to the latest version mit python3.
I can see the timestamps in Grafana and that they´re very irregular.
The Nagios status says "Service check timed out after 60.01 seconds".
The only positive effect is that Grafana now shows negative values for Receive Level :-)

What data do you need to investigate that issue?
My TC4400 and the rest of my network doesn´t changed.
I´m running Nagios Core Version 4.4.3 on CentOS Linux release 7.8.2003 (Core).

kind regards
Michael

CheckMK 2.0 ?

I would like to know if this check is already made for checkMK 2.0?
and how to install it?
Will there be a MKP in future?

KeyError: 'Receive Level'

Hi, changed from epc3212 to tc-4400 but I can't get your script running.

TC-4000:
Software Version: | 70.12.42-190604
Linux Version: | 3.14.28-Prod_18.1

/check_tc4400.py -u admin -p asdfghswdg -H 192.168.100.1

Traceback (most recent call last):
  File "./check_tc_4400.py", line 255, in <module>
    main()
  File "./check_tc_4400.py", line 138, in main
    rlvl = float(re.search(floaty, ds["Receive Level"]).group(0))
KeyError: 'Receive Level'
root@icinga2:/usr/local/sbin# ./check_tc_4400.py -u admin -p IbiG10JzSg 
Traceback (most recent call last):
  File "./check_tc_4400.py", line 255, in <module>
    main()
  File "./check_tc_4400.py", line 138, in main
    rlvl = float(re.search(floaty, ds["Receive Level"]).group(0))
KeyError: 'Receive Level'

http://192.168.100.1/cmconnectionstatus.html works with this credentials.
What I'm doing wrong? please advice :-)

Thanks!

Negative values for receive level will captured as positive values

Hi there,

i found a bug or mishandling of negative receive level values.
I´m not sure if this is a Nagios oder check_tc4400 problem.
Nagios shows the OFDM values like this:
dn32_cwcorr=266038494c;;; dn32_cwfail=1890470150c;;; dn32_cwpass=2621806538c;;; dn32_rlvl=0.4;;; dn32_snr=32.0
While the TC4400 website shows the values like this:

Channel Index	Channel ID	Lock Status	Channel Type	Bonding Status	Center Frequency	Width	SNR/MER Threshold Value	Receive Level	Modulation/Profile ID	Unerrored Codewords	Corrected Codewords	Uncorrectable Codewords
32	32	Locked	OFDM Downstream	Bonded	823000000 Hz	86000 kHz	32.0 dB	-0.4 dBmV	0, 1, 2	2622038028	266069980	1890579029

Could you pleas check if this is an bug of the check_tc4400 plugin?

kind regards
Michael