Retour à la topologie
DOCUMENTATION TECHNIQUE

Pandora FMS Agent

pandora-fms-agent.md

Pandora FMS Agent

Ce que fait ce service

Agent de monitoring Pandora FMS (version 7.0NG.783). Collecte des métriques système (CPU, charge, RAM, réseau, I/O disque, connexions TCP) et les envoie au serveur Pandora FMS via le protocole Tentacle sur 192.168.1.47:41121. Les données sont transmises sous forme de fichiers XML.

Où il est installé

  • Binaire : /usr/bin/pandora_agent
  • Configuration : /etc/pandora/pandora_agent.conf
  • Environnement : /etc/pandora/pandora_agent.env + /etc/pandora/pandora_agent_extra.env
  • Logs : /var/log/pandora/pandora_agent.log
  • Répertoire temporaire : /var/spool/pandora/tmp/pandora_agent_daemon
  • Fichier systemd : /etc/systemd/system/pandora_agent_daemon.service
  • Configuration actuelle

    /etc/systemd/system/pandora_agent_daemon.service :
    [Unit]
    Description=Pandora FMS agent daemon
    After=network-online.target
    
    [Service]
    User=root
    PIDFile=/var/run/pandora_agent_daemon.pid
    ExecStartPre=/usr/bin/clean_pandora_agent_daemon
    ExecStart=/usr/bin/pandora_agent /etc/pandora
    Restart=on-failure
    RestartPreventExitStatus=1
    EnvironmentFile=/etc/pandora/pandora_agent.env
    EnvironmentFile=/etc/pandora/pandora_agent_extra.env
    
    [Install]
    WantedBy=multi-user.target
    /etc/pandora/pandora_agent.conf (paramètres clés) :
    server_ip       192.168.1.47
    server_path     /var/spool/pandora/data_in
    server_port     41121
    transfer_mode   tentacle
    interval        300
    remote_config   1
    group           Servers
    agent_name_cmd  __rand__
    Modules collectés :
    module_name CPU Load          → vmstat 1 2 | awk (CPU user %)
    module_name CPU IOWait        → vmstat 1 2 | awk (iowait %)
    module_name Load Average      → cat /proc/loadavg (1min)
    module_name TCP_Connections   → netstat -an | grep tcp count
    module_plugin pandora_df_used      → usage disque
    module_plugin pandora_mem_used     → usage mémoire
    module_plugin pandora_netusage     → usage réseau
    module_plugin autodiscover --default
    module_plugin net_usage
    /etc/pandora/pandora_agent.env :
    TMPDIR=/var/spool/pandora/tmp/pandora_agent_daemon
    PATH=$PATH:/bin:/usr/bin:/sbin:/usr/sbin:/usr/local/bin
    DAEMON_TENTACLE=/usr/bin/tentacle_server

    Ports et réseau

  • Port en écoute : aucun (optionnel : UDP 41122 pour recevoir des ordres, désactivé ici udp_server 0)
  • Connexion vers : 192.168.1.47:41121 (TCP, protocole Tentacle)
  • Fréquence d'envoi : toutes les 5 minutes (300 secondes)
  • Variables d'environnement

    Définies dans les fichiers d'environnement systemd :
    VariableValeur
    ------
    TMPDIR/var/spool/pandora/tmp/pandora_agent_daemon
    PATH$PATH:/bin:/usr/bin:/sbin:/usr/sbin:/usr/local/bin
    DAEMON_TENTACLE/usr/bin/tentacle_server

    Dépendances

  • Dépend de : serveur Pandora FMS sur 192.168.1.47:41121 (Tentacle)
  • Est utilisé par : tableau de bord Pandora FMS sur 192.168.1.47 pour la supervision
  • Commandes

    Voir le statut

    systemctl status pandora_agent_daemon.service

    Voir les logs

    ```bash

    Log systemd :

    journalctl -u pandora_agent_daemon.service -n 50

    Log fichier (plus détaillé) :

    tail -50 /var/log/pandora/pandora_agent.log ```

    Démarrer

    systemctl start pandora_agent_daemon.service

    Arrêter

    systemctl stop pandora_agent_daemon.service

    Redémarrer

    systemctl restart pandora_agent_daemon.service

    Logs — Dernière activité

    2026/04/24 16:20:25 - [remote config] - Uploading configuration for the first time.
    2026/04/24 16:20:29 - [error] - Error sending file '...conf' to '192.168.1.47:41121': Cannot connect to 192.168.1.47 on port 41121: No route to host.
    2026/04/24 16:20:32 - [error] - Error sending file '...md5' to '192.168.1.47:41121': Cannot connect to 192.168.1.47 on port 41121: No route to host.
    2026/04/24 16:25:26 - [error] - Error retrieving file: '...md5' Cannot connect to 192.168.1.47 on port 41121: No route to host.
    2026/04/24 16:25:29 - [error] - Error sending file '...conf' to '192.168.1.47:41121': Cannot connect to 192.168.1.47 on port 41121: No route to host.

    Points d'attention

  • ALERTE : Le serveur Pandora FMS (192.168.1.47:41121) est actuellement injoignable — toutes les tentatives d'envoi échouent avec No route to host. Le monitoring est non-fonctionnel.
  • - L'agent redémarre automatiquement (Restart=on-failure) et retente toutes les 5 minutes. - Vérifier que la VM/machine 192.168.1.47 est allumée et que le service Pandora FMS tourne dessus.
  • remote_config 1 est activé : l'agent tente de télécharger sa configuration depuis le serveur central — ce qui échoue aussi actuellement.
  • agent_name_cmd __rand__ : le nom de l'agent est généré aléatoirement à chaque démarrage. Cela peut créer des doublons dans l'interface Pandora si l'agent est redémarré. Normalement le hash de la machine (af289ce159d0...) sert de nom stable dans ce cas.
  • • Le service se redémarre automatiquement chaque nuit à minuit (vu dans les logs systemd — probablement dû à une tâche cron ou timer systemd).