Monitor

Le Monitor est une sonde de surveillance distribuee qui execute des verifications, collecte des donnees de performance et transmet les resultats. Deployez plusieurs instances a travers votre infrastructure pour une surveillance distribuee.

Vue d’ensemble

Gestion du service

Commandes CLI

# Install as service and register with the Webserver
monitor install <webserver_ip>:<port>

# Re-register with the Webserver (e.g., after IP change)
monitor register <webserver_ip>:<port>

# Migrate to a new Webserver (regenerates the certificate, re-registers)
monitor migrate <webserver_ip>:<port> <jwt_token>

# Start / Stop / Restart the service
monitor start
monitor stop
monitor restart

# Run in foreground (Docker or debugging)
monitor run

# Remove the service
monitor uninstall

# Display help
monitor help

Lors de l'install, le Monitor :

1. Cree l’arborescence des repertoires
2. Genere une paire de cles RSA et des certificats TLS
3. Envoie une demande d’auto-enregistrement au Webserver
4. Televerse son certificat TLS pour la verification mTLS

Configuration

Le fichier monitor.json se trouve dans le meme repertoire que l’executable :

{
  "name": "probe1",
  "port": "8051",
  "webserver": "192.168.1.100:8050",
  "integratorEndPoint": "",
  "location": "Paris",
  "description": "Production monitoring probe",
  "logLevel": "info",
  "concurrencyLimit": "100",
  "dataRetention": "336",
  "backupInterval": "24",
  "nbDaysBackup": "336",
  "autoThreshold": "true"
}

Parametres principaux

Configuration du navigateur (pour les moniteurs Web UI / EUM)

Seuils automatiques

Le Monitor peut calculer automatiquement les seuils de performance a partir des donnees historiques en utilisant une analyse statistique (multiplicateurs d’ecart-type) :

Une tache nocturne (02h00) recalcule les seuils via moyenne + (multiplicateur * ecart-type) sur les executions reussies des moniteurs actives uniquement. Les moniteurs Ping recoivent aussi des seuils de gigue (jitterThreshCri/Maj/Min). Voir Configuration du Monitor → Calcul automatique des seuils pour la formule complete et les conseils de reglage.

Integration Vault

Rotation des journaux

Arborescence des repertoires

<install_dir>/
├── monitor(.exe)            # Executable
├── monitor.json             # Configuration du service
├── config/
│   ├── sec/                 # Cles RSA pour JWT
│   └── ssl/                 # Certificats TLS pour mTLS
├── data/                    # Fichiers de definition des moniteurs (JSON)
├── dbs/                     # Bases de donnees cle-valeur integrees (une par type)
│   ├── exec.db              # Moniteurs Web UI / EUM
│   ├── url.db               # Moniteurs HTTP/HTTPS URL
│   ├── api.db               # Moniteurs REST API
│   ├── tcp.db               # Moniteurs TCP port
│   ├── ping.db              # Moniteurs ICMP ping
│   ├── nslookup.db          # Moniteurs DNS lookup
│   ├── db.db                # Moniteurs de requetes base de donnees
│   ├── sys.db               # Moniteurs de metriques systeme
│   ├── snmp.db              # Moniteurs SNMP
│   ├── chart.db             # Donnees de graphiques/performance
│   ├── monitor.db           # Donnees generales des moniteurs
│   ├── metrics.db           # Metriques propres a la sonde (CPU, memoire)
│   ├── host.db              # Inventaire des hotes
│   ├── device.db            # Inventaire des equipements
│   └── backup/              # Sauvegardes automatisees
├── log/                     # Fichiers journaux avec rotation
├── scripts/                 # Scripts personnalises pour les moniteurs
├── actions/                 # Scripts d'actions (notifications, remediation)
├── exec/                    # Executables specifiques a la plateforme (webdrivers)
└── export/                  # Exports de donnees

Types de moniteurs

1. Web UI / EUM (End User Monitoring)

Base de donnees : exec.db

Execute des parcours utilisateur multi-etapes a l’aide de Selenium WebDriver. Supporte les navigateurs Chrome, Firefox et Edge.

Capacites :

• Enregistrement de transactions multi-etapes (via MNS IDE ou Selenium IDE)
• Capture d’ecran a chaque etape
• Enregistrement video de l’execution complete
• Capture de fichiers HAR (HTTP Archive)
• Chronometrage individuel des transactions avec seuils
• Support TOTP (Time-based One-Time Password) pour l’authentification a deux facteurs (RFC 6238 — 6 chiffres / 30 s / SHA-1)
• Configuration de proxy
• Verification de similarite visuelle

Voir la page dediee Moniteur EUM pour la specification complete (compatibilite TOTP/Okta, integration des coffres-forts, fonctions de script).

Fonctions de script MNS IDE :

mnsStartTransaction("Login Page", 30, 5000, 3000); // name, timeout, critical_ms, major_ms
driver.findElement(By.id("username")).sendKeys("user");
driver.findElement(By.id("password")).sendKeys("pass");
driver.findElement(By.id("submit")).click();

2. HTTP/HTTPS URL

Base de donnees : url.db

Verifications HTTP GET simples avec des metriques de temps detaillees.

Metriques collectees :

• Temps de resolution DNS
• Temps de connexion TCP
• Temps de negociation TLS (avec detection de la version TLS)
• Temps de traitement serveur
• Temps de transfert du contenu
• Temps de reponse total
• Code de statut HTTP
• Taille du contenu
• Date d’expiration du certificat SSL

Fonctionnalites supplementaires :

• Correspondance de motifs dans le corps de la reponse
• Validation du code de statut
• Verification et alerte d’expiration du certificat

3. REST API

Base de donnees : api.db

Surveillance complete d’endpoints API avec methodes HTTP, en-tetes et corps de requete personnalises.

Methodes supportees : GET, POST, PUT, DELETE

Fonctionnalites :

• En-tetes de requete personnalises
• Configuration du corps de la requete
• Correspondance de motifs dans le corps de la reponse
• Mesure du temps de reponse
• Validation du code de statut

4. TCP Port

Base de donnees : tcp.db

Verifications de connectivite sur les ports TCP.

Metriques :

• Succes/echec de la connexion
• Temps de connexion
• Resolution de l’IP de destination

5. ICMP Ping

Base de donnees : ping.db

Requetes ICMP Echo Request/Reply pour tester l’accessibilite reseau.

Metriques :

• Latence minimale / maximale / moyenne
• Gigue (ecart-type)
• Paquets envoyes / recus / perdus
• Taux de perte de paquets

6. DNS Lookup (Nslookup)

Base de donnees : nslookup.db

Surveillance de la resolution DNS.

Metriques :

• Temps de resolution DNS
• Validation de la reponse

7. SNMP

Base de donnees : snmp.db

Interrogation SNMP pour la surveillance des equipements reseau.

Fonctionnalites :

• Support SNMP v1/v2c/v3
• Requetes OID avec expressions MIB
• Calculs de delta entre les interrogations
• Evaluation d’expressions sur les valeurs collectees

8. Database Query

Base de donnees : db.db

Surveillance de la connectivite et de l’execution de requetes sur les bases de donnees.

Bases de donnees supportees :

• MySQL
• Microsoft SQL Server (MSSQL)

Metriques :

• Temps d’execution de la requete
• Validation des resultats
• Temps de connexion

9. System Metrics

Base de donnees : sys.db

Auto-surveillance de l’hote de la sonde.

Metriques :

• Pourcentage d’utilisation CPU
• Utilisation memoire
• Utilisation disque

Planification

Chaque type de moniteur dispose de son propre planificateur cron independant (utilisant robfig/cron/v3). Cette isolation garantit qu’un type de moniteur lent ne peut pas bloquer les autres types.

Planifications predefinies

Controle de la concurrence

Un semaphore global limite le nombre d’executions simultanees de moniteurs (configurable via concurrencyLimit, valeur par defaut : 100). Chaque execution acquiert un emplacement avant de demarrer et le libere a la fin, empechant l’epuisement des ressources sur l’hote de la sonde.

Alertes

Le Monitor peut envoyer des alertes directement sans avoir besoin d’un Integrator.

Canaux de notification

Declencheurs d’alertes

Actions personnalisees

Les scripts d’action peuvent etre places dans le repertoire actions/ et configures par moniteur. Ils s’executent automatiquement en cas d’echec ou de changement de statut avec un delai d’expiration configurable.

Endpoints de l’API REST

Authentification

Gestion des moniteurs

Recuperation des donnees

Creation par type

Configuration

Stockage des donnees

Chaque type de moniteur stocke ses resultats dans sa propre base de donnees cle-valeur integree avec plusieurs buckets par moniteur :

Tous les horodatages sont stockes en millisecondes Unix (epoch en ms).

Les donnees sont automatiquement purgees en fonction du parametre dataRetention (valeur par defaut : 336 heures / 14 jours).

Voir aussi

• Configuration du Monitor – reference complete des parametres
• API HTTP du Monitor – documentation complete de l’API
• Operations de surveillance – guide de l’interface pour la gestion des moniteurs
• Vue d’ensemble de la plateforme – comment le Monitor s’integre dans l’architecture
• Exception lors de l’execution d’un moniteur – resolution des erreurs de moniteur

Traductions

• en: Monitor