Sur cette page

Assistant de configuration des composants

L’assistant de configuration des composants (Component Config Builder) est un assistant conversationnel guide qui genere un fichier de configuration pret a l’emploi pour chaque composant Mugnsoft : un Probe (monitor.json), un Integrator (integrator.json) ou un Discovery Agent (discovery_agent.json). Repondez a quelques questions — l’assistant remplit tous les autres parametres avec des valeurs par defaut adaptees a la production.

Ouvrir l’assistant

Depuis la page Components :

  • cliquez sur l'icone robot dans la barre d’outils (a cote du bouton “plus”), ou
  • cliquez sur Build config file dans le message affiche quand aucun composant n’est encore enregistre.

Les droits administrateur sont requis.

Fonctionnement

  1. Choisissez un type de composant — Probe, Integrator ou Discovery Agent.
  2. Repondez aux questions — texte libre, nombre, ou puces de choix en un clic. Une puce ← Back permet de revenir a la question precedente a tout moment ; une nouvelle reponse ecrase simplement la precedente.
  3. Verifiez le recapitulatif — avant toute generation, l’assistant affiche un resume de toutes vos reponses. Cliquez sur le crayon a cote d’un champ pour ne modifier que cette reponse ; vous revenez ensuite directement au recapitulatif.
  4. Generez — cliquez sur Generate config. Un apercu repliable du contenu exact du fichier apparait dans la conversation.
  5. Telechargez ou copiez — utilisez Download config pour enregistrer le fichier, ou Copy JSON pour copier son contenu dans le presse-papiers.
  6. Deployez — copiez le fichier a cote du binaire du composant sur la machine cible et demarrez le service. Le composant s’auto-enregistre aupres du webserver au demarrage :
# Linux
./discovery_agent install && ./discovery_agent start

# Windows
discovery_agent.exe install && discovery_agent.exe start
Les secrets sont masques. Les reponses sensibles (token de bot Slack, cle API PagerDuty) sont saisies dans un champ de type mot de passe et affichees sous forme de •••••••• dans la conversation et le recapitulatif. Elles ne sont ecrites en clair que dans le fichier genere.

Si une reponse echoue a la validation finale, l’assistant revient directement a la question concernee pour la corriger — inutile de tout recommencer.

Express vs Custom (Discovery Agent)

Le parcours Discovery Agent commence par un choix de mode :

  • Express (recommande) — vous ne repondez qu’aux 5 questions essentielles : nom, application, port, processus et planification. Tout le reste utilise les valeurs par defaut listees ci-dessous.
  • Custom — parcourt toutes les options : intervalle de capture, systemes de fichiers, seuils de trafic par processus, URLs, APIs, moniteurs de logs, moniteurs de dossiers, notifications…

Chaque parametre peut etre affine plus tard dans le formulaire Details du composant sur la page Components.

Valeurs par defaut du mode Express

Les tableaux ci-dessous listent toutes les valeurs ecrites par l’assistant en mode Express (ou quand vous passez une question optionnelle en mode Custom). Consultez la reference de configuration du Discovery Agent pour la signification de chaque champ.

Lecture des tableaux de seuils. *AutoThreshold: "true" signifie que les seuils sont appris a partir de l’historique — les valeurs *FixedThresh* associees ne servent que si vous desactivez ensuite le seuil automatique. Une valeur vide ("") signifie non defini : aucune alerte pour cette severite (affiche ∞ dans l’interface).

Collecte & decouverte

Cle Defaut
discoCapInterval "10" (secondes de capture de trafic par cycle)
discoFSGMonitored "C:"
ports / probeEndPoint / tags / location / description ""
integratorEndPoint "" (pas d’integrator)
trafficThresholds {} (alerting de trafic par processus desactive)
urls / apis / logMonitors / dirMonitors non definis

Moteur de seuils automatiques

Cle Defaut
discoGAutoThresholdRange / discoPAutoThresholdRange "24" (heures d’historique)
discoGAutoThreshCri / discoPAutoThreshCri "6" (facteur d’ecart-type)
discoGAutoThreshMaj / discoPAutoThreshMaj "4"
discoGAutoThreshMin / discoPAutoThreshMin "2"

Metriques systeme (globales)

Toutes les metriques systeme sont activees (*GMonEnabled: "true").

Metrique Auto Fixe Cri / Maj / Min
discoCPUG* "true" 99 / 98 / 0.01
discoMEMG* "true" 99 / 98 / 97
discoLoadAvg1minG* / 5minG* / 15minG* "true" 200 / 150 / 100
discoFSG* "true" 99 / 98 / 97
discoFSInodesG* "true" 98 / 96 / 90
discoTCPSocketsG* "true" non defini
discoCpuIOWaitG* "false" non defini (collecte, jamais d’alerte)
discoDiskQueueG* "false" non defini (collecte, jamais d’alerte)
discoDiskUtilG* "true" 95 / 85 / 70
discoDiskReadRateG* / discoDiskWriteRateG* "true" 500 / 300 / 100
discoNetBytesRateG* "true" 100000000 / 50000000 / 10000000
discoNetTxDropsG* "false" non defini (collecte, jamais d’alerte)
discoSwapInRateG* / discoSwapOutRateG* "true" 1048576 / 524288 / 102400

Metriques par processus

Toutes les metriques par processus sont activees (*PMonEnabled: "true") et en seuil automatique (*PAutoThreshold: "true").

Metrique Fixe Cri / Maj / Min (utilise seulement si l’auto est desactive plus tard)
discoCPUP* 98 / 96 / 90
discoMEMP* non defini / 3 / 1
discoSWAPP* non defini / 3 / 1
discoCPUUserP* non defini
discoIostatReadP* / discoIostatWriteP* non defini
discoNumThreadsP* / discoNumFDsP* non defini

Notifications & actions

Cle Defaut
notifyStatus "MINOR" (severite minimale declenchant une notification)
notifyAfter "1" (depassements consecutifs avant la premiere alerte)
notifyFor "2" (cycles d’alerte)
emailOnF / emailOnSC / slackOnF / slackOnSC / teamsOnF / teamsOnSC / pdOnF / pdOnSC "false"
emailR ""
scriptOnF / scriptOnSC "false", scriptAction / scriptActionT ""
integratorRetryQueueSize "500"

Service & journalisation

Cle Defaut
logLevel "info"
logCompress "true"
maxSize "10" (Mo par fichier de log)
maxBackups "5"
maxAge "28" (jours)
logMaxLinesPerTick "100000"
backupInterval "24" (heures entre les sauvegardes du KV)
nbDaysBackup "336" (heures de retention des sauvegardes)

L’assistant resout aussi automatiquement webserver (le point de terminaison auquel le composant se rapporte) et le secret interne partage depuis le webserver en cours d’execution — vous ne les saisissez jamais.

Parcours Probe et Integrator

Les deux parcours sont courts (pas de choix Express/Custom) :

  • Probe — nom, port (defaut 8072), localisation, description, selection optionnelle d’un integrator (recuperee en direct depuis le webserver). Produit monitor.json avec le seuil automatique active (24 h d’historique, facteurs d’ecart-type 8/6/4).
  • Integrator — nom, port (defaut 8060), description, puis une section oui/non par canal de notification : Email (destinataires uniquement — les parametres SMTP sont herites du webserver), PagerDuty, Slack, Microsoft Teams. Produit integrator.json.

Consultez les references de configuration du Probe et de l'Integrator pour la liste complete des champs.

Traductions

Operations sur les composants