Project – GNMRADAR overview
Contexte, architecture, documentation et périmètre open source.
What is GNMRADAR?
Moteur de supervision construit from scratch : collecte → normalisation → stockage → API → UI.
Monitoring engine Observability Linux MySQL REST API Dashboards
Product overview
GNMRADAR est une implémentation de référence basée sur le core GNM (Collector + API + DB). La visualisation reste découplée.
Scope
Core + Demo UI
Engine / API / DB + dashboard de démonstration
Open-source
Collector + API
Licence GPL-3.0 sur les couches core
Model
Active checks
Mesures déterministes + statut OK/WARN/CRIT
Design
Decoupled UI
L’UI est optionnelle. Chacun peut brancher son dashboard.
Official links
Documentation technique, code source et démo publique.
Architecture
Architecture backend-first, testable et remplaçable brique par brique.
  • Collectexécution de checks actifs (ICMP/HTTP/DNS/TCP/TLS/JSON).
  • Storepersistance des mesures dans MySQL (télémétrie structurée).
  • APIexposition des états et séries temporelles via endpoints REST.
  • UIdashboard optionnel, consommateur de l’API.
CollectorMySQLREST APIDashboard (optional)
ThreadPoolExecutor 2-strikes anti false-positive Geo-IP probe region JSON metadata
Open-source scope
Périmètre publié : uniquement le core (Collector + API) et la doc. Le reste reste hors dépôt.
  • Included (GPL-3.0)Collector, API backend, schéma DB, documentation.
  • ExcludedUI production, configuration réelle, automatisation de déploiement, intégrations commerciales.
  • Intentpublier un moteur de supervision réutilisable, indépendant du provider et du dashboard.
Technology stack (demo)
Stack de référence utilisée pour GNMRADAR (la visualisation peut varier).
  • Python 3 — Collector & API
  • MySQL — Telemetry store
  • REST — Data exposure
  • Bootstrap — UI demo
Documentation (GitHub)
Documentation “enterprise-style” : architecture, installation, systemd, schéma DB, guide dashboard.
  • docs/installation-guide.mdinstallation complète (collector + API + DB)
  • docs/collector-architecture.mdarchitecture collector (threads, statuts, 2-strikes)
  • docs/api-architecture.mdarchitecture API (endpoints, agrégation, filtres)
  • docs/database-schema.mdschéma DB + index strategy + status model
  • docs/dashboard-design-guide.mdguide pour créer son propre dashboard (UI découplée)
  • docs/dashboard-integration.mdcontrat API + exemples de requêtes et patterns d’intégration
Ouvrir le dépôt GitHub (documentation + core)