Add CI badge and Linux end-to-end health check job

Author: dev-rajnishg

.github/workflows/ci.yml

@@ -64,4 +64,98 @@ jobs:
 
       - name: Import Flask App
         working-directory: python/dashboard
-        run: python -c "from app import app; print(app.url_map)"
+        run: python -c "from app import app; print(app.url_map)"
+
+  health-check:
+    name: linux-e2e-health-check
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Configure CMake
+        run: cmake -S . -B build
+
+      - name: Build Native Targets
+        run: cmake --build build --config Release
+
+      - name: Start Server and Agent
+        shell: bash
+        run: |
+          ./build/sysnetmon-server 9090 > /tmp/sysnetmon-server.log 2>&1 &
+          echo $! > /tmp/sysnetmon-server.pid
+          sleep 1
+          ./build/sysnetmon-agent 127.0.0.1 9090 ci-agent-1 1 > /tmp/sysnetmon-agent.log 2>&1 &
+          echo $! > /tmp/sysnetmon-agent.pid
+          sleep 4
+
+      - name: Validate Live Snapshot
+        shell: bash
+        run: |
+          python3 - <<'PY'
+          import json
+          import socket
+
+          sock = socket.create_connection(("127.0.0.1", 9090), timeout=5)
+          register = {"type": "register", "role": "dashboard", "host": "ci-health-check"}
+          sock.sendall((json.dumps(register) + "\n").encode("utf-8"))
+          sock.settimeout(4)
+
+          chunks = []
+          try:
+              while True:
+                  data = sock.recv(4096)
+                  if not data:
+                      break
+                  chunks.append(data.decode("utf-8"))
+                  if "\"type\":\"snapshot\"" in chunks[-1] or "\"type\": \"snapshot\"" in chunks[-1]:
+                      break
+          except socket.timeout:
+              pass
+          finally:
+              sock.close()
+
+          lines = []
+          for chunk in chunks:
+              lines.extend([line for line in chunk.splitlines() if line.strip()])
+
+          snapshot = None
+          for line in lines:
+              try:
+                  obj = json.loads(line)
+              except Exception:
+                  continue
+              if obj.get("type") == "snapshot":
+                  snapshot = obj
+                  break
+
+          if snapshot is None:
+              raise SystemExit("No snapshot event received from server")
+
+          metrics = snapshot.get("metrics", [])
+          if not metrics:
+              raise SystemExit("Snapshot did not contain host metrics")
+
+          hosts = {m.get("host") for m in metrics}
+          if "ci-agent-1" not in hosts:
+              raise SystemExit("Expected ci-agent-1 in snapshot metrics")
+
+          print("Health check passed. Hosts:", sorted(hosts))
+          PY
+
+      - name: Dump logs on failure
+        if: failure()
+        shell: bash
+        run: |
+          echo "===== server log ====="
+          cat /tmp/sysnetmon-server.log || true
+          echo "===== agent log ====="
+          cat /tmp/sysnetmon-agent.log || true
+
+      - name: Stop Processes
+        if: always()
+        shell: bash
+        run: |
+          if [ -f /tmp/sysnetmon-agent.pid ]; then kill $(cat /tmp/sysnetmon-agent.pid) 2>/dev/null || true; fi
+          if [ -f /tmp/sysnetmon-server.pid ]; then kill $(cat /tmp/sysnetmon-server.pid) 2>/dev/null || true; fi

README.md

@@ -1,5 +1,9 @@
 # SysNetMon
 
+## CI Status
+
+[![Cross-Platform CI](https://github.com/dev-rajnishg/SysNetMon/actions/workflows/ci.yml/badge.svg)](https://github.com/dev-rajnishg/SysNetMon/actions/workflows/ci.yml)
+
 SysNetMon is a distributed system monitor built as an infra-focused monorepo for systems and networking roles. It combines a low-level C++ TCP server, cross-platform C++ monitoring daemons, a Python Flask dashboard with Plotly, and AWS alert delivery using S3 and SNS.
 
 The native code now targets Windows, macOS, and Linux. The socket layer uses portable `select`-based TCP handling, while metric collection switches to each platform's native APIs: `/proc` on Linux, Mach and `getifaddrs` on macOS, and Win32 or IP Helper APIs on Windows.
@@ -140,6 +144,9 @@ GitHub Actions workflow `.github/workflows/ci.yml` validates the repo on:
 - macOS
 - Linux
 
+It includes a lightweight Linux end-to-end health check that starts the C++ server and one agent, then validates that a dashboard socket client receives a snapshot containing live metrics.
+- Linux
+
 CI builds `sysnetmon-server` and `sysnetmon-agent` with CMake on each OS, and runs Flask dashboard dependency plus import checks.
 
 ## AWS Configuration