Skip to content

Latest commit

 

History

History
117 lines (96 loc) · 3.51 KB

README.md

File metadata and controls

117 lines (96 loc) · 3.51 KB

zabbix-arris-tm1602

Zabbix template for monitoring ARRIS TM1602 Cable Modems

The default trigger values and graph limits are based on:

Dependencies

  • curl
  • gawk
  • html-xml-utils (for hxnormalize)
  • sed
  • xmlstarlet
  • pup

Installation

  • Copy the scripts to your Zabbix ExternalScripts location (default: /usr/lib/zabbix/externalscripts)
  • Make sure the script permissions allow the zabbix server to execute them
  • Import the template file into the Zabbix UI

Setup and Configuration

  • Create a new host "Cable Modem"
  • Link the new host to the template
  • If modem is not using 192.168.100.1 create a host macro {$MODEM_ADDRESS} to set a custom IP address
  • In Monitoring->Latest Data validate that the "Check Status" item has valid results

What is Provided

Out of the box the template has a number of items, triggers, and graphs as well as discovery rules to provide individual channel details

Template Items

  • Check Status (5min refresh, text of status results)

    • Boot (last value from config screen)
    • Configuration (last value from config screen)
    • Connectivity (last value from config screen)
    • Downsteam Channels (count)
    • Downstream Power (min/avg/max)
    • Downstream SNR (min/avg/max)
    • Downstream Corrected Errors (total accross all channels)
    • Downstream Uncorrectable Errors (total accross all channels)
    • Upstream Channels (count)
    • Upstream Power (min/avg/max)
    • Upstream Symbol Rate (min/avg/max)
  • Ping (30sec refresh)

    • Simple up/down check
    • Response time

Template Triggers

Trigger values are based on template macros so they can be overriden locally

  • Downstream Channel MISSING
  • Downstream Power(avg) LOW
  • Downstream Power(avg) HIGH
  • Downstream SNR(avg) LOW
  • Downstream Corrected Errors large increase
  • Downstream Uncorrectable Errors large increase
  • Upstream Channel MISSING
  • Upstream Power(avg) LOW
  • Upstream Power(avg) HIGH
  • Ping HIGH LATENCY
  • Ping offline

Template Graphs

  • Downstream Channels (count)
  • Downstream Power
  • Downstream SNR
  • Corrected Errors
  • Uncorrectable Errors
  • Upstream Channels (count)
  • Upstream Power
  • Upstream Symbol Rate
  • Ping Response Time

All 9 graphs are included on a monitoring screen as well

Downstream Channel Discovery

Downstream channel discovery is run once a day and parses the status page information to create a list of channels. Each channel has items, triggers and graphs created.

Downstream Channel Items

  • Status
  • Modulation (64QAM, 256QAM, etc)
  • Frequency (MHz)
  • Power (dBmV)
  • SNR (dB)
  • Corrected Errors
  • Uncorrectable Errors

Downstream Channel Triggers

Trigger values are based on template macros so they can be overriden locally

  • Power LOW
  • Power HIGH
  • SNR LOW

Downstream Channel Graphs

  • Power
  • SNR

Upstream Channel Discovery

Upstream channel discovery is run once a day and parses the status page information to create a list of channels. Each channel has items, triggers and graphs created.

Upstream Channel Items

  • Status
  • Channel Type (ATDMA, etc)
  • Frequency (MHz)
  • Power (dBmV)
  • Symbol Rate (kSym/s)

Upstream Channel Triggers

Trigger values are based on template macros so they can be overriden locally

  • Power LOW
  • Power HIGH

Upstream Channel Graphs

  • Power
  • Symbol Rate