Discovery Agent

Le Discovery Agent surveille l’hote sur lequel il s’execute, decouvre les services, collecte les metriques systeme et processus, et genere des alertes basees sur des seuils.

Vue d’ensemble

Gestion du service

Commandes CLI

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

# Re-register with the Webserver
discovery_agent register <webserver_ip>:<port>

# Migrate to a new Webserver
discovery_agent migrate <webserver_ip>:<port> <jwt_token>

# Start / Stop / Restart
discovery_agent start
discovery_agent stop
discovery_agent restart

# Run in foreground
discovery_agent run

# Remove the service
discovery_agent uninstall

Configuration

Parametres principaux

{
  "name": "agent1",
  "port": "8070",
  "webserver": "192.168.1.100:8050",
  "integratorEndPoint": "192.168.1.100:8052",
  "location": "Datacenter-1",
  "sched": "5MIN",
  "processes": "nginx,mysql,java",
  "ports": "80,443,3306",
  "logLevel": "info"
}

Options de planification

Arborescence des repertoires

<install_dir>/
├── discovery_agent(.exe)     # Executable
├── discovery_agent.json      # Configuration du service
├── config/
│   ├── sec/                  # Cles RSA
│   └── ssl/                  # Certificats TLS
├── data/
│   ├── process_list.txt      # Noms des processus surveilles
│   ├── port_list.txt         # Ports reseau surveilles
│   ├── process_thresholds.json   # Configuration des seuils par processus
│   ├── system_thresholds.json    # Configuration des seuils systeme
│   ├── discover_metrics.json     # Dernieres metriques collectees
│   └── alerts.json           # Alertes generees
├── dbs/                      # Bases de donnees cle-valeur integrees
│   ├── discovery.db          # Donnees de decouverte principales
│   ├── metrics.db            # Historique des metriques
│   ├── process.db            # Donnees des processus
│   ├── system.db             # Donnees systeme
│   └── backup/               # Sauvegardes automatisees
└── log/                      # Fichiers journaux avec rotation

Mecanismes de decouverte

Decouverte des processus

Le Discovery Agent surveille les processus par nom. Configurez les processus a surveiller :

Methode 1 : Fichier de configuration

{
  "processes": "nginx,mysqld,java,python3"
}

Methode 2 : Fichier de liste de processus (data/process_list.txt)

nginx:web,production
mysqld:database,production
java:application
python3.12:scripts

Format : nomprocessus[.exe]:tag1,tag2 (separe par deux-points, avec tags optionnels)

Decouverte des ports

Surveillez quels processus ecoutent sur des ports specifiques :

Fichier de configuration :

{
  "ports": "80,443,3306,5432,8080"
}

Fichier de liste de ports (data/port_list.txt) :

80
443
3306
5432

L’agent associe les ecouteurs de ports aux noms de processus via l’enumeration des connexions TCP.

Decouverte du trafic reseau

Utilise la capture de paquets (pcap) via la bibliotheque gopacket pour l’analyse du trafic en direct :

• Capture les paquets sur toutes les interfaces reseau
• Duree configurable via discoCapInterval
• Agrege le trafic par identifiant de processus (PID)
• Calcule la bande passante en kbits/s (entrant/sortant)
• Genere un graphique de topologie reseau au format Cytoscape pour la visualisation

Moniteurs delegues (controles URL / API / port)

Au-dela des metriques de l’hote, un agent de decouverte peut definir des controles synthetiques — urls, apis, pings, nslookups, tcps, dbs et syss — directement dans sa configuration. L’agent n’execute pas ces controles lui-meme ; il les delegue a une ou plusieurs sondes Monitor nommees dans probeEndPoint.

{
  "appName": "Shop",
  "probeEndPoint": "probe1,probe-win2",
  "ports": "80,443,3306",
  "urls": [{ "name": "shop-home", "url": "https://shop.example.com/" }],
  "apis": [
    {
      "name": "checkout-api",
      "url": "https://api.example.com/health",
      "typeApi": "GET"
    }
  ]
}

Cela permet de decrire toute la surface de service d’un hote (sante systeme et ses endpoints) au meme endroit, tandis que l’execution reelle des URL/API se fait sur une sonde ayant un acces reseau aux cibles.

Metriques collectees

Metriques systeme

Metriques par processus

Activation/desactivation des metriques

Chaque metrique peut etre activee ou desactivee individuellement :

{
  "discoCPUGMonEnabled": "true",
  "discoMEMGMonEnabled": "true",
  "discoLoadAvg5minGMonEnabled": "true",
  "discoCPUPMonEnabled": "true",
  "discoMEMPMonEnabled": "true",
  "discoSWAPPMonEnabled": "false"
}

Configuration des seuils

Seuils fixes

Definissez des valeurs de seuil explicites par metrique :

{
  "discoCPUGFixedThreshCri": "95",
  "discoCPUGFixedThreshMaj": "85",
  "discoCPUGFixedThreshMin": "75"
}

Seuils automatiques

Laissez l’agent calculer les seuils a partir des donnees historiques :

{
  "discoCPUPAutoThreshold": "true",
  "discoMEMPAutoThreshold": "true"
}

Les seuils automatiques utilisent une analyse statistique (ecart-type) des metriques historiques pour definir dynamiquement les valeurs de seuil.

Quand le seuil automatique est active pour une metrique, laissez les champs *FixedThresh* correspondants vides (""). L’interface web affiche ces champs avec ∞ : pendant le calcul de la baseline (periode de warm-up), aucune alerte n’est emise pour cette metrique.

Seuils de trafic

Seuils de trafic reseau par processus avec operateurs directionnels :

{
  "trafficThresholds": {
    "nginx": {
      "operator": ">",
      "critical": 10000,
      "major": 5000,
      "minor": 1000
    }
  }
}

Operateurs : > (alerter lorsque au-dessus) ou < (alerter lorsque en dessous).

Alertes

Niveaux de statut des alertes

Canaux de notification

Identiques aux autres composants :

Temporisation des alertes

Routage des alertes

Les alertes peuvent etre acheminees de deux facons :

1. Via l’Integrator (recommande) – le Discovery Agent envoie les metriques a l’Integrator, qui gere les alertes de maniere centralisee
2. Alertes locales – le Discovery Agent envoie les alertes directement via les canaux configures (lorsqu’aucun Integrator n’est configure)

La concurrence est controlee par des semaphores : 20 goroutines simultanees pour la communication avec l’Integrator, 10 pour les alertes locales.

Flux d’execution

Cron trigger (every N minutes)
  |
  v
execDiscovery()
  |
  v
runDiscoveryMetrics()
  ├── CollectSystemMetrics()    --> CPU, memory, load, FS, sockets
  ├── CollectProcessMetrics()   --> per-process CPU, memory, I/O, traffic
  ├── CollectNetworkMetrics()   --> pcap traffic capture, connections
  └── GenerateCytoscapeData()   --> network topology graph
  |
  v
Write data/discover_metrics.json + data/alerts.json
  |
  v
discoveryDataFile()
  ├── processMetricsKV()    --> evaluate per-process thresholds
  ├── systemMetricsKV()     --> evaluate system thresholds
  └── Route alerts:
       ├── goDataSent2Integrator()   (if Integrator configured)
       └── goHandleAlerting()         (local fallback)

Taches cron en arriere-plan

Endpoints de l’API REST

Authentification

Decouverte

Acces aux donnees

Parametres

Sante

Sauvegarde et restauration

Certificats

Journaux

Traductions

• en: Sentinel Agent