Skip to content
activeSystemsStarted: Sep 1, 2026

NetPulse TG — ISP Watchdog & Telegram Incident Relay

MikroTik RouterOS & ISP Uptime Watchdog with Sub-Second Jitter Detection and Telegram Outage Alerts.

View Source

Technology Stack

PythonFastAPIDockerTelegram Bot APIMikroTik RouterOSPrometheus

My Role

Solo Systems Architect

System Architecture
  1. 1Gateway ICMP & TCP Probe
  2. 2Jitter & Packet Loss Evaluator
  3. 3Incident State Machine
  4. 4Telegram Alert Dispatcher
  5. 5Prometheus Metrics Exporter
  • 1Gateway ICMP & TCP Probe──▶2Jitter & Packet Loss Evaluator
  • 2Jitter & Packet Loss Evaluator──▶3Incident State Machine
  • 3Incident State Machine──▶4Telegram Alert Dispatcher
  • 2Jitter & Packet Loss Evaluator──▶5Prometheus Metrics Exporter

Overview

In mission-critical retail and edge computing environments across Bangladesh, intermittent fiber breaks and upstream ISP packet degradation can quietly paralyze POS terminals and cloud sync daemons.

NetPulse TG is a containerized infrastructure watchdog engineered to continuously probe upstream gateway health, evaluate round-trip jitter, and instantly notify network administrators via Telegram long before end users experience outages.

Key Capabilities

  • High-Frequency Gateway Probing: Executes configurable sub-second ICMP and TCP ping sweeps against multiple reference DNS servers and local ISP BDIX gateways.
  • Jitter & Degraded State Machine: Detects soft degradation (packet loss exceeding 8% or latency variance >50ms) before a total link drop occurs, suppressing false-positive notification storms.
  • Instant Telegram Incident Dispatch: Sends structured Markdown incident alerts detailing packet loss percentages, hops affected, and estimated recovery times.
  • Zero-Cloud Architecture: Operates entirely within local Docker containers or lightweight edge devices with Prometheus metrics exposed on a local port.

Interactive Source Explorer & Live CLI Sandbox

Browse source implementation and execute in-browser sandbox simulation.

GitHub Repo
$netpulse-probe --target 8.8.8.8,1.1.1.1 --interval 0.5s
Source Tree (1 Files)
probe.pypython
import subprocess
import time

def ping_gateway(host: str = "8.8.8.8", count: int = 3):
    cmd = ["ping", "-c", str(count), "-W", "1", host]
    res = subprocess.run(cmd, capture_output=True, text=True)
    return res.returncode == 0

Project Changelog

Engineered Sub-Second Prober

Built multi-target ICMP probe with exponential smoothing for round-trip latency.

Dual WAN Failover Triggers

Integrated direct MikroTik RouterOS API hooks to automate gateway failover.

Knowledge Graph

Timeline

PreviousS.A.R.A. Task Control Plane & Telegram RelayNextBD Biz Normalizer — Phone, Geo District & SME Data Sanitizer

Conceptually Related

S.A.R.A. Task Control Plane & Telegram RelayVia: Python, FastAPI, Telegram Bot API...WA Reminder Companion: Headless Due Notification BridgeVia: Python, FastAPI, Python...BD Biz Normalizer — Phone, Geo District & SME Data SanitizerVia: Python, FastAPI, PythonKhata2Sheet AI: Local OCR & Bengali Ledger DigitizerVia: Python, FastAPI, Python