Choisir les serveurs à collecter

Le fichier de configuration du collecteur dit comment se connecter :

adresse d'InfraRiver ;
certificat ;
jetons ;
compte et port SSH ;
modules.

Il ne dit pas quoi collecter. La liste des serveurs se tient dans InfraRiver, sur la page du collecteur (InfraRiver Collector → le collecteur), et le collecteur la relit à chaque cycle.

Générer le bundle

Dans InfraRiver Collector — Config, le formulaire « Générer un bundle pour un collecteur » demande :

Champ	Rôle
Nom commun (CN)	Identité du collecteur
URL InfraRiver	Adresse que le collecteur utilise pour joindre InfraRiver
Compte SSH	Compte créé par `infrariver-agent` sur les serveurs à interroger (le même pour toutes les cibles)
Port SSH	Port unique pour toutes les cibles (22 par défaut)
Modules activés	Posture (par défaut), certificats, logiciels

Le bundle contient aussi un jeton propre au collecteur, qui ne sert qu'à lire sa liste de serveurs. Réémettre le bundle remplace ce jeton : l'ancien est refusé.

La liste des collecteurs

La page InfraRiver Collector — Config liste tous les collecteurs ; le nom de chacun est un lien vers sa page. Pour chaque collecteur :

état ;
mode ;
dernier contact ;
nombre de serveurs envoyés ;
dernière émission du bundle.

Les collecteurs installés avec un ancien bundle y figurent aussi, en mode « Fichier ». Dessous, l'historique des émissions de bundle.

La page du collecteur

Informations

Le bloc affiche :

l'état (actif / désactivé) ;
le mode : piloté par le serveur, ou fichier pour un collecteur installé avec un ancien bundle ;
le dernier contact (date, adresse, version du collecteur) ;
le nombre de serveurs envoyés au dernier appel et leur répartition par transport (SSH · NRPE · Zabbix · SNMP).

Outil manquant sur le collecteur

Si un outil manque sur le collecteur (check_nrpe, zabbix_get, snmpbulkwalk) et que des serveurs de ce transport sont affectés, un avertissement le dit : ces serveurs sont ignorés tant que l'outil n'est pas installé.

« Désactiver » coupe immédiatement la liste : le collecteur ne reçoit plus rien jusqu'à la réactivation.

Règles automatiques

Une règle est un filtre de l'inventaire des serveurs. Un serveur qui entre dans l'inventaire et correspond à une règle est collecté au cycle suivant.

Pour créer une règle :

Appliquez des filtres dans le tableau (colonnes ou filtre avancé).
Donnez un nom.
Cliquez « Enregistrer les filtres du tableau comme règle ».

Vous pouvez aussi importer un de vos filtres enregistrés de la page Serveurs ; la règle en garde une copie indépendante. « Voir les serveurs » affiche dans le tableau les serveurs que la règle attrape.

Un filtre vide est refusé. Pour collecter tout l'inventaire, cochez explicitement « Tous les serveurs de l'inventaire ».

Une règle peut aussi imposer un transport (colonne « Transport imposé ») à tous les serveurs qu'elle attrape. Les flèches ▲ ▼ règlent la priorité : si deux règles imposent des transports différents au même serveur, la plus haute l'emporte et la ligne du serveur affiche « conflit de règles ».

Profils d'accès

Un profil dit comment joindre un serveur en NRPE, Zabbix ou SNMP : port, commande ou clé, identifiants. SSH n'a pas de profil : son compte et son port sont ceux du bundle.

Chaque transport a un profil « Défaut » prérempli avec les valeurs livrées avec les paquets. Vous pouvez en ajouter d'autres, par exemple « SNMP v3 réseau » et « SNMP v2c ancien parc ». La liste n'affiche que les champs qui ont un sens pour le profil : un profil SNMP v2c n'a ni utilisateur, ni protocoles v3.

Transport	Valeurs par défaut
NRPE	port 5666, commande `check_sockets`, délai 15 s
Zabbix (passif)	port 10050, clé `check_sockets`, délai 15 s
SNMP	port 161, version 3 `authPriv` (SHA / AES), délai 15 s, 1 nouvel essai

Une valeur que vous modifiez est mise en évidence et la valeur du paquet reste affichée ; « revenir au défaut » (ou vider le champ) la rétablit. Un profil que vous n'avez pas modifié suit les valeurs d'une mise à jour des paquets.

Les secrets (communauté SNMP v2c, mots de passe SNMP v3) sont chiffrés et ne sont jamais réaffichés : à la modification, un champ laissé vide conserve le secret enregistré.

Situation	Conséquence
Profil SNMP sans identifiants	Marqué « à compléter » : les serveurs qui l'utilisent ne sont pas envoyés et la ligne du serveur dit ce qui manque
Profil utilisé par des serveurs, des choix manuels ou des règles	Ne peut pas être supprimé
Transport NRPE	Signalé comme le transport le moins sûr ; l'avertissement n'empêche rien
SNMP v2c	Signalé comme transmettant la communauté en clair ; l'avertissement n'empêche rien

Tableau des serveurs

Une case par serveur.

Rattachement	Sens
Coché à la main	Vous l'avez ajouté
Règle « … »	Une règle l'attrape (case cochée)
Exclu à la main	Une règle l'attrape, mais vous l'avez retiré
Hyperviseur	Jamais collecté (case grisée)

La colonne Transport (filtrable) donne, pour chaque serveur coché, le transport utilisé et son profil. Par défaut c'est SSH. Il n'y a pas de mode automatique : le transport est toujours explicite.

Le transport se choisit dans la liste de la ligne, ou pour plusieurs serveurs à la fois avec la liste « Transport de la sélection… » puis « Appliquer ». « Retirer le choix manuel » revient à la règle, puis à SSH.

Priorité : choix fait à la main sur la ligne, puis règle, puis SSH.

Décocher un serveur attrapé par une règle crée une exclusion ; le recocher la supprime. Les boutons « Cocher la sélection » / « Décocher la sélection » agissent sur les lignes cochées.

La carte en tête indique combien de serveurs seront envoyés au prochain cycle, par transport. Un serveur peut être rattaché à deux collecteurs (par exemple pendant un déménagement) : le tableau le signale.

Tester un serveur

« Tester la sélection » (20 serveurs au plus, NRPE / Zabbix / SNMP) demande au collecteur de lancer, à son prochain appel, la même interrogation en lecture seule que pendant un cycle normal, sans rien enregistrer.

Le résultat s'affiche dans la colonne « Test » : « OK — 14 ports en écoute, 37 connexions établies », ou le message d'erreur tel que l'outil l'a produit.

Note

InfraRiver ne joint jamais les serveurs lui-même : seul le collecteur est dans la bonne zone réseau. Le test n'existe pas pour SSH.

Ce qui est envoyé

liste = (serveurs attrapés par une règle active ∪ serveurs cochés) − exclusions − hyperviseurs − serveurs sans aucune adresse, répartie par transport. Le collecteur choisit l'adresse de chaque serveur dans l'ordre FQDN, adresse IP, nom d'hôte.

Les secrets d'un profil (SNMP) ne sont transmis que si le collecteur appelle par le canal protégé par certificat client (mTLS). Sans mTLS, les serveurs qui utilisent un profil à secrets sont ignorés avec le message « secrets refusés hors mTLS » ; NRPE et Zabbix, qui n'ont pas de secret, fonctionnent dans les deux cas.

Si le collecteur ne parvient pas à lire sa liste (réseau coupé, jeton refusé), il saute le cycle SSH et l'écrit dans son journal, et saute aussi les cycles NRPE, Zabbix et SNMP.

Dans ce mode, les listes nrpe.targets / zabbix.targets / snmp.targets du fichier sont ignorées ; un avertissement est écrit si elles sont remplies.

infrariver_collector.py --check affiche le nombre de serveurs reçus pour chaque transport, les serveurs ignorés et les outils manquants.