Configuration du Monitor

Le fichier de configuration du Monitor controle l’identite de la sonde, la connectivite, le comportement de planification, les parametres d’automatisation du navigateur, le calcul automatique des seuils et l’integration avec les coffres-forts de secrets.

Configuration du service (monitor.json)

Ce fichier doit se trouver dans le meme repertoire que l’executable.

Exemple complet

{
  "name": "probe-paris-01",
  "port": "8051",
  "webserver": "192.168.1.100:8050",
  "integratorEndPoint": "192.168.1.100:8052",
  "location": "Paris, France",
  "description": "Production monitoring probe - Paris DC",
  "logLevel": "info",
  "concurrencyLimit": "100",
  "dataRetention": "336",
  "backupInterval": "24",
  "nbDaysBackup": "336",
  "maxBackups": "5",
  "maxSize": "10",
  "maxAge": "28",
  "logCompress": "true",
  "chromeBinPath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
  "firefoxBinPath": "",
  "edgeBinPath": "",
  "chromeVersion": "",
  "firefoxVersion": "",
  "edgeVersion": "",
  "autoThreshold": "true",
  "autoThresholdRange": "24",
  "autoThreshCri": "8",
  "autoThreshMaj": "6",
  "autoThreshMin": "4",
  "autoThreshTimeout": "10",
  "autoTransThreshold": "false",
  "vaultType": "",
  "hashiCorpVaultUrl": "",
  "hashiCorpVaultToken": "",
  "azureKVUrl": "",
  "cyberarkConjurUrl": ""
}

Reference des parametres

Identite et reseau

Gestion des donnees

Journalisation

Configuration des navigateurs

Requis pour les moniteurs Web UI / EUM qui utilisent Selenium WebDriver :

Calcul automatique des seuils

Calculez automatiquement les seuils de performance bases sur les donnees historiques en utilisant l’analyse de l’ecart-type :

Fonctionnement : Une tache nocturne (02h00) collecte les N dernieres heures de donnees de performance (autoThresholdRange), calcule la moyenne et l’ecart-type, puis definit les seuils comme suit :

Timeout  = moyenne + (autoThreshTimeout * ecart-type)   // plafond d'execution
Critical = moyenne + (autoThreshCri     * ecart-type)
Major    = moyenne + (autoThreshMaj     * ecart-type)
Minor    = moyenne + (autoThreshMin     * ecart-type)

Notes :

• Seules les executions reussies entrent dans le calcul de la moyenne/ecart-type — les echecs et expirations sont exclus pour ne pas fausser la baseline.
• Seuls les moniteurs actives (state = on) sont mis a jour.
• autoTransThreshold applique le meme calcul par etape de transaction (02h05).
• Les moniteurs Ping recoivent en plus des seuils de gigue (jitterThreshCri/Maj/Min), calcules a partir de la moyenne + ecart-type de la gigue avec les memes multiplicateurs.

Methode par centile (robuste, recommandee pour une latence bruitee)

Definir thresholdMethod a "percentile" pour calculer les seuils a partir de la distribution empirique de latence plutot que moyenne+ecart-type. La latence est asymetrique a droite : les centiles correspondent a la semantique SLO et resistent aux valeurs aberrantes. Le timeout est un centile eleve multiplie par un facteur de securite, borne par un plancher absolu, ce qui elimine le piege de la fausse panne lie a un ecart-type quasi nul.

La methode s’applique a tous les types de moniteurs — url, api, tcp, udp, ping, nslookup, db, snmp, wmi, sys et les etapes de transaction EUM (exec). Pour l’EUM, les seuils Mineur/Majeur par etape utilisent autoThreshMinPct / autoThreshCriPct ; les etapes en dessous de autoThreshMinSamples retombent sur le modele historique max×coefficient.

Anti-rebond des alertes (suppression du battement sur changement de statut)

Les alertes a l’echec sont deja anti-rebondies par les reglages par moniteur notifyAfter / notifyFor (alerte seulement apres N echecs consecutifs). debounceStatusChange etend la meme garde consecutive aux notifications de changement de statut : un echantillon transitoire unique (par ex. un timeout ponctuel) ne declenche plus d’alerte a l’aller-retour. Reutilise le notifyAfter existant du moniteur comme profondeur.

Integration avec les coffres-forts de secrets

Pour recuperer des secrets (mots de passe, cles API, graines TOTP) depuis des coffres-forts externes au moment de l’execution :

Pour savoir comment les identifiants du coffre-fort et les secrets TOTP sont transmis aux scenarios EUM a l’execution (VAULT_USERNAME_<urlTitle>, VAULT_PASSWORD_<urlTitle>, TOTP_SECRET_<urlTitle>), voir la page Moniteur EUM. Pour le workflow de configuration de bout en bout, voir Coffres-forts de secrets.

Parametres par moniteur

Chaque moniteur individuel possede ses propres parametres, configures via l’interface Web ou l’API. Ceux-ci sont stockes dans le magasin cle-valeur integre, et non dans le fichier JSON.

Groupes de motifs (URL & API)

Les moniteurs URL et API evaluent le corps de la reponse avec un ou plusieurs groupes de motifs. Chaque groupe extrait une seule valeur avec sa propre regexp et l’evalue selon ses propres seuils. Le statut du moniteur est le plus severe de tous les statuts de groupe et du statut de temps de reponse.

Un seul groupe peut etre configure via les champs herites ci-dessus (le groupe principal). Les groupes supplementaires sont stockes dans le champ patterns sous forme de tableau JSON ; lorsqu’il est renseigne, il decrit entierement l’evaluation (le groupe principal en est la premiere entree).

Correspondance de contenu vs. extraction de valeur

Le motif principal (pattern / patternUrl) fonctionne selon deux modes, choisis automatiquement selon que la regexp contient un groupe de capture :

• Correspondance de contenu — pas de (groupe de capture). Une simple verification de presence : le corps de la reponse doit contenir le motif (sous-chaine ou regexp). Sinon, le moniteur echoue (ERROR). Aucun operateur ni seuil ne s’applique ; les seuils de temps de reponse continuent d’evaluer la latence.
• Extraction de valeur — un (groupe de capture). Le texte capture est evalue selon l’operateur et les seuils Mineur / Majeur / Critique ci-dessous. C’est ce qu’est un groupe de motifs.

Les lignes supplementaires du tableau patterns sont toujours des groupes d’extraction de valeur. (Un motif principal en mode correspondance de contenu combine a des groupes de valeur supplementaires n’est pas re-verifie en mode multi-groupes — conservez le principal comme correspondance de contenu ou comme groupe de valeur.)

Champs par groupe

Operateurs de comparaison

Pour chaque palier, le palier correspondant le plus severe l’emporte ; les paliers vides sont ignores, donc un groupe peut par exemple ne definir qu’un seuil Critique.

Exemple patterns

[
  { "name": "length",  "pattern": "\"length\"\\s*:\\s*(\\d+)", "matchIndex": "1",
    "comp": "number >", "min": "1000", "maj": "1500", "cri": "2000" },
  { "name": "fact",    "pattern": "\"fact\":(.*)",              "matchIndex": "1",
    "comp": "string contains", "min": "cats", "maj": "", "cri": "" },
  { "name": "updated", "pattern": "\"updated\":\"([^\"]*)\"",   "matchIndex": "1",
    "comp": "datetime older than", "min": "", "maj": "1h", "cri": "24h" }
]

Les valeurs capturees par groupe sont stockees sous STATUS_PATTERN/<moniteur>/<groupe> pour les graphiques d’historique ; les groupes supprimes ou renommes sont purges du magasin lors de la prochaine sauvegarde du moniteur.

Traductions

• en: Monitor Configuration