Installer l'agent serveur, étape par étape

Installez l'agent InfraNest sur un serveur pour obtenir des données de mémoire, d'espace disque et de charge. Ce guide s'adresse à toute personne qui configure la surveillance sur un serveur qu'elle gère, et prend environ deux minutes par serveur.

NoteVous voulez d'abord savoir pourquoi l'installer et ce qu'il collecte ? Lisez Obtenir la mémoire, l'espace disque et la charge avec l'agent — cet article suppose que vous avez déjà décidé de continuer.

Aperçu

• L'agent est un petit programme que vous installez une seule fois sur le serveur lui-même, à l'aide d'un token à usage unique fourni par InfraNest.
• Il n'envoie des données vers l'extérieur que sur le port 443 — rien n'a besoin d'être ouvert vers le serveur, et aucune règle de pare-feu ne doit être modifiée.
• Une fois qu'il fonctionne, les données de mémoire, d'espace disque et de charge du serveur commencent à apparaître dans InfraNest, et les règles d'alerte qui nécessitaient l'agent deviennent disponibles.

Avant de commencer

Vous avez besoin de trois choses :

• Un serveur dans InfraNest. S'il n'y est pas encore, ajoutez-le sous Infrastructure → Serveurs.
• Un accès administrateur à ce serveur — sudo sous Linux, une PowerShell Administrateur sous Windows. Vous en avez besoin une seule fois, pour l'installation. L'agent lui-même ne s'exécute pas ensuite en tant qu'administrateur.
• Le serveur doit pouvoir accéder à Internet sur le port 443. En sortie uniquement.

Vous n'avez pas besoin d'ouvrir un port, d'installer un dépôt de gestionnaire de paquets, ou de donner à InfraNest un autre accès à la machine.

Obtenir la commande d'installation

1. Choisissez Install the agent — vous le trouverez sur la ligne du serveur dans Monitoring → Serveurs, dans le menu d'actions du serveur, ou à côté d'une règle d'alerte grisée parce qu'elle nécessite l'agent. Les trois ouvrent la même fenêtre.
2. Rien n'est demandé : le token est créé immédiatement. Dans la liste des tokens qui suit, chacun est identifié par qui l'a ajouté, quand, et la dernière fois qu'il a été utilisé.
3. Le token est affiché une seule fois. En dessous se trouve une commande d'installation prête à l'emploi, avec le token déjà renseigné.
4. Choisissez l'onglet correspondant à votre système et copiez la commande.

WarningRéservez le token à un seul serveur. Il identifie quel serveur transmet les données. Si deux machines partagent un token, elles écrivent dans le même ensemble de graphiques et rien ne le détecte — les chiffres se mélangent, et l'alerte « le serveur ne répond plus » ne peut jamais se déclencher, car la machine encore active continue de se signaler pour les deux.

Exécuter la commande d'installation

Ubuntu et Debian

Collez la commande dans un terminal sur ce serveur. Elle se présente ainsi :

curl -fsSL https://github.com/InfraNest-Infrastructure-Organized/infranest-agent/releases/latest/download/install.sh \
  | sudo sh -s -- --token sat_YOUR_TOKEN

Testée sur Ubuntu 20.04, 22.04 et 24.04, ainsi que Debian 11 et 12.

RHEL, Rocky, AlmaLinux, CentOS Stream, Fedora

Exactement la même commande. Le programme d'installation télécharge un binaire unique et crée un service systemd ; il n'utilise pas de gestionnaire de paquets, donc la distribution n'a pas d'importance tant qu'elle utilise systemd.

Si curl est manquant, installez-le d'abord avec sudo dnf install curl.

Windows Server

Ouvrez PowerShell en tant qu'administrateur et exécutez :

irm https://github.com/InfraNest-Infrastructure-Organized/infranest-agent/releases/latest/download/install.ps1 -OutFile install.ps1
.\install.ps1 -Token sat_YOUR_TOKEN

Testée sur Windows Server 2019 et 2022. Elle s'installe dans C:\Program Files\InfraNest et s'exécute en tant que tâche planifiée nommée InfraNest agent.

Un serveur sans systemd

Alpine, un conteneur, ou tout système utilisant OpenRC ou runit : le programme d'installation place le binaire et le fichier de configuration, puis vous indique qu'il n'a pas pu créer de service. Exécutez infranest-agent run sous le superviseur utilisé par ce système. L'agent doit rester en fonctionnement continu ; il ne s'agit pas d'une tâche ponctuelle.

Vérifier que cela a fonctionné

1. Dans InfraNest : attendez environ une minute et rechargez la page du serveur. La mémoire, l'espace disque et la charge moyenne commencent à se remplir, le badge de couverture passe à Agent, et les règles d'alerte auparavant grisées deviennent disponibles.
2. Sur le serveur, si vous préférez vérifier localement, exécutez :

sudo infranest-agent status

& "C:\Program Files\InfraNest\infranest-agent.exe" status

Cela indique si les données sont bien transmises et, si ce n'est pas le cas, pourquoi. La réponse repose uniquement sur ce qui se trouve sur la machine et ne contacte rien d'autre.

Notesudo est nécessaire car le fichier de configuration contient un identifiant et n'est lisible que par l'utilisateur propre de l'agent. Sans cela, vous obtiendrez une erreur concernant un token manquant plutôt que des permissions.

Lire le script avant de l'exécuter

Si vous préférez examiner le script au préalable, le panneau d'installation propose ce chemin avec la même mise en avant que la commande en une ligne :

curl -fsSLO https://github.com/InfraNest-Infrastructure-Organized/infranest-agent/releases/latest/download/install.sh
sha256sum install.sh        # comparer avec la somme de contrôle affichée dans InfraNest
less install.sh             # environ 200 lignes
sudo sh install.sh --token sat_YOUR_TOKEN

La somme de contrôle affichée à côté de la commande dans InfraNest est celle publiée avec la version, la comparaison constitue donc une vérification réelle. Le script lui-même n'est pas l'agent — il télécharge un binaire versionné et le vérifie par rapport à sa propre somme de contrôle publiée avant de l'installer.

Garder le token hors de l'historique de votre shell

Une ligne de commande se retrouve dans l'historique de votre shell et est visible pendant son exécution. Sur une machine partagée, utilisez plutôt un fichier de token :

printf '%s' 'sat_YOUR_TOKEN' | sudo tee /root/token >/dev/null
sudo sh install.sh --token-file /root/token && sudo shred -u /root/token

Mettre à jour l'agent

1. Exécutez de nouveau la même commande d'installation. Elle remplace le binaire et conserve votre configuration et votre token.

InfraNest vous informe lorsqu'une mise à jour est disponible : la carte System du serveur affiche la version de l'agent, et le tableau de la flotte signale les serveurs utilisant une version plus ancienne.

Supprimer l'agent

1. Exécutez la commande de désinstallation correspondant à votre système :

sudo sh install.sh --uninstall

.\install.ps1 -Uninstall

Cela supprime le service, l'utilisateur, le binaire, la configuration et les données enregistrées.

WarningSupprimer le token dans InfraNest ne désinstalle rien — cela arrête simplement l'acceptation des données. L'agent continue de fonctionner et de réessayer sur la machine jusqu'à ce que vous le supprimiez à cet endroit.

Résolution des problèmes

Si aucun de ces cas ne correspond, exécutez :

sudo infranest-agent flare

Cela affiche tout ce dont une conversation avec le support a besoin — version, configuration, état, ce qui n'a pas pu être lu — avec le token retiré. Collez cela dans un ticket de support plutôt que votre fichier de configuration.