PingIQ
Monitoring

Script checks (SNMP extend)

Run your own check scripts on any device and monitor them over SNMP — no SSH or agent needed.

Many devices can't run an agent and don't allow SSH — but almost everything speaks SNMP. net-snmp's standard `extend` directive exposes any command's output and exit code over SNMP; PingIQ reads both with a single poll and applies your assertions.

Setup on the target

One line in snmpd.conf, then restart snmpd:

snmpd.conf
extend raid /usr/local/bin/check_raid.sh
extend certdays /usr/local/bin/cert_days_left.sh

Assertions per check

  • Expected exit code (default 0)
  • Output must contain / must NOT contain a text snippet
  • Warn/critical thresholds on the first number in the output — direction-aware: alert when above (temperature) or below (free space, days to expiry)

Alerts & history

  • Down (agent unreachable or extend entry missing), assertion-failed and recovery alerts — after 3 consecutive non-ok checks, like every PingIQ sensor
  • Recent results view with status, exit code, parsed value and output per check

Security

  • SNMP v2c and v3 supported; credentials are encrypted at rest and masked in the UI
  • The probe only reads two OIDs under nsExtendObjects — no write access needed on the device
Prefer the SSH sensor when you have shell access and want host health (CPU/memory/disk) too; script checks shine on appliances, NAS boxes and locked-down servers.