maxxoverclocker / uptimekuma-pfsense-gw-status

pfSense scripts to report gateway status to UptimeKuma

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

pfSense shell script for reporting gateway status to Uptime Kuma

Simple script that will report the current gateway status in pfSense to Uptime Kuma. Supports multiple WANs. Will report 'PACKETLOSS' and 'LATENCY' as 'msg' to Uptime Kuma as well as 'UP' or 'DOWN' as 'status'.

Screenshots

image

Requirements

  • pfSense 2.5.2, 2.6.0 (Untested on any other release)
  • pfSense Package: Shellcmd 1.0.5_2 (Untested on any other version)
  • pfSense Package: Cron 0.3.8_1
  • Python 3.8 (Untested on any other version)

Install/Use

  1. In a local directory ex: /root/local-scripts/uptime-kuma-gateway-status, place dpinger-gateway-status.py, uptime-kuma-gateway-status.csh, and uptime-kuma-gateway-dictionary.txt

  2. Modify uptime-kuma-gateway-status.csh to reflect your WAN gateway names and Uptime Kuma URL:

  • set gateway_names = 'WAN_1_DHCP WAN_2_DHCP'
  • set uptime_kuma_url = 'http://uptime-kuma.example.com:3001'
  1. Modify uptime-kuma-gateway-dictionary.txt to reflect both your WAN gateway names as well as the unique Push URL generated from Uptime Kuma

  2. Using the Shellcmd package in pfSense, create a new Shellcmd Configuration:

  • Command: nohup /bin/csh /root/local-scripts/uptime-kuma-gateway-status/uptime-kuma-gateway-status.csh >/dev/null 2>&1 &
  • Shellcmd Type: shellcmd
  • Description: uptime-kuma-gateway-status.csh image
  1. NEW - Using the Cron package in pfSense, create a new Cron schedule:
  • Minute: */15
  • Hour: *
  • Day of the Month: *
  • Month of the Year: *
  • Day of the Week: *
  • User: root
  • Command: nohup /bin/csh /root/local-scripts/uptime-kuma-gateway-status/uptime-kuma-gateway-status.csh >/dev/null 2>&1 & image
  1. Reboot and enjoy!

About

pfSense scripts to report gateway status to UptimeKuma


Languages

Language:Shell 78.9%Language:Python 21.1%