Surveillance de serveur / VM

Un moniteur Serveur / VM surveille une machine grâce à l'agent d'infrastructure Status200 (oneuptime-infrastructure-agent), un petit service qui envoie à Status200, toutes les 30 secondes, le CPU, la mémoire, les disques, la charge, le réseau et les processus en cours. Cette page explique comment connecter l'agent à un moniteur Serveur / VM, ce que l'agent remonte et comment écrire les critères qui décident quand le serveur est en ligne ou hors ligne.

Fonctionnement#

L'agent s'exécute comme service système. Toutes les 30 secondes, il collecte un rapport et l'envoie à votre URL Status200, signé avec la clé secrète du moniteur. Status200 enregistre les valeurs comme métriques du moniteur et vérifie le rapport par rapport aux critères du moniteur.

Le silence est vérifié séparément. Chaque minute, Status200 réévalue les critères Is Online de chaque moniteur Serveur / VM qui n'a rien envoyé depuis 3 minutes ou plus, et un serveur silencieux plus longtemps que ses critères ne le permettent (3 minutes par défaut) est considéré hors ligne. Un moniteur sans critère Is Online n'est jamais marqué hors ligne simplement parce que l'agent s'est tu. Seul le temps pendant lequel Status200 recevait des données compte dans ce silence : le temps pendant lequel Status200 lui-même redémarrait, était mis à jour ou rattrapait son retard ne compte pas, comme l'explique Quand Status200 ne reçoit pas de données.

Avant de commencer#

• Un moniteur Serveur / VM dans votre projet.
• L'autorisation de modifier les moniteurs. La clé secrète, et les commandes de configuration qui la contiennent, ne sont montrées qu'aux personnes qui peuvent modifier les moniteurs.
• Les droits root (Linux, macOS) ou Administrateur (Windows) sur le serveur. L'agent s'installe comme service système.
• Un accès HTTPS sortant du serveur vers votre URL Status200, directement ou via un proxy HTTP.

Connecter l'agent#

Les commandes ci-dessous utilisent https://status200.ru et YOUR_SECRET_KEY. Les commandes de configuration du moniteur contiennent déjà votre URL Status200 et la clé secrète du moniteur ; copiez-les donc depuis le moniteur quand c'est possible.

1. Ouvrir les commandes de configuration du moniteur#

   Allez dans Moniteurs, ouvrez le moniteur Serveur / VM et sélectionnez Documentation. Les cartes Set up your Server Monitor (Linux/Mac) et Set up your Server Monitor (Windows) contiennent les commandes de ce moniteur. Tant que l'agent n'a pas envoyé son premier rapport, la Vue d'ensemble du moniteur les affiche aussi.

2. Installer l'agent#

   LinuxmacOSWindows

   Linux

   Sur Debian et Ubuntu, ajoutez le dépôt apt de Status200 et installez l'agent depuis celui-ci :

   Bash

   sudo install -m 0755 -d /etc/apt/keyrings
   sudo curl -fsSL https://packages.status200.ru/gpg.key -o /etc/apt/keyrings/status200.asc
   sudo chmod a+r /etc/apt/keyrings/status200.asc
   echo "deb [signed-by=/etc/apt/keyrings/status200.asc] https://packages.status200.ru/deb stable main" | sudo tee /etc/apt/sources.list.d/status200.list
   sudo apt-get update
   sudo apt-get install oneuptime-infrastructure-agent

   Sur RHEL, Rocky Linux, AlmaLinux, Fedora et Amazon Linux, ajoutez le dépôt yum de Status200 et installez l'agent depuis celui-ci. Utilisez yum là où dnf n'existe pas, et acceptez la clé de signature de Status200 quand elle vous est demandée.

   Bash

   sudo curl -fsSL https://packages.status200.ru/rpm/status200.repo -o /etc/yum.repos.d/status200.repo
   sudo dnf install oneuptime-infrastructure-agent

   Sur toute autre distribution, utilisez le script d'installation :

   Bash

   curl -sSL https://status200.ru/docs/static/scripts/infrastructure-agent/install.sh | sudo bash

   macOS

   Installez l'agent avec Homebrew :

   Bash

   brew install oneuptime/tap/status200-infrastructure-agent

   Ou utilisez le script d'installation :

   Bash

   curl -sSL https://status200.ru/docs/static/scripts/infrastructure-agent/install.sh | sudo bash

   Windows

   Dans l'Invite de commandes ouverte en tant qu'administrateur, installez l'agent avec winget :

   Shell

   winget install --id OneUptime.InfrastructureAgent --exact --scope machine

   Rouvrez ensuite l'Invite de commandes en tant qu'administrateur, pour que oneuptime-infrastructure-agent soit dans son chemin.

   Sans winget, téléchargez l'agent vous-même :

   1. Téléchargez l'agent depuis la dernière version GitHub : oneuptime-infrastructure-agent_windows_amd64.zip pour x64, ou oneuptime-infrastructure-agent_windows_arm64.zip pour ARM64.
   2. Extrayez le fichier ZIP. Il contient oneuptime-infrastructure-agent.exe.
   3. Ouvrez l'Invite de commandes en tant qu'administrateur dans le dossier où vous l'avez extrait.

   Pour déployer l'agent avec Intune, Configuration Manager ou une stratégie de groupe, utilisez oneuptime-infrastructure-agent-amd64.msi (ou oneuptime-infrastructure-agent-arm64.msi) de la même version. Il installe l'agent dans C:\Program Files\OneUptimeInfrastructureAgent, et un MSI plus récent le met à jour sur place et le redémarre. Un MSI d'une version antérieure ne peut pas être mis à jour : désinstallez-le d'abord une fois.

   Chaque méthode installe la version la plus récente pour votre système d'exploitation et votre processeur (x86-64 ou ARM64). Les dépôts apt et yum contiennent les paquets .deb et .rpm joints à chaque version GitHub, signés avec la clé publiée à https://packages.status200.ru/gpg.key, et les paquets placent le binaire dans /usr/bin. Le script d'installation place le binaire oneuptime-infrastructure-agent dans $HOME/bin. Sur une installation auto-hébergée, le script est servi par votre propre URL Status200.

3. Le connecter au moniteur#

   LinuxmacOSWindows

   Linux

   Bash

   sudo oneuptime-infrastructure-agent configure --secret-key=YOUR_SECRET_KEY --oneuptime-url=https://status200.ru

   macOS

   Bash

   sudo oneuptime-infrastructure-agent configure --secret-key=YOUR_SECRET_KEY --oneuptime-url=https://status200.ru

   Windows

   Shell

   oneuptime-infrastructure-agent configure --secret-key=YOUR_SECRET_KEY --oneuptime-url=https://status200.ru

   configure enregistre la clé secrète et l'URL dans le fichier de configuration de l'agent et installe l'agent comme service système. Les deux options sont obligatoires. Sur une installation auto-hébergée, remplacez https://status200.ru par votre propre URL.

   Si le serveur accède à Internet via un proxy, ajoutez --proxy-url :

   Bash

   sudo oneuptime-infrastructure-agent configure --proxy-url=http://proxy.example.com:8080 --secret-key=YOUR_SECRET_KEY --oneuptime-url=https://status200.ru

4. Démarrer l'agent#

   LinuxmacOSWindows

   Linux

   Bash

   sudo oneuptime-infrastructure-agent start

   macOS

   Bash

   sudo oneuptime-infrastructure-agent start

   Windows

   Shell

   oneuptime-infrastructure-agent start

   Au démarrage, l'agent vérifie la clé secrète auprès de Status200 et envoie immédiatement son premier rapport.

5. Vérifier qu'il remonte des données#

   Exécutez sudo oneuptime-infrastructure-agent status (sans sudo sous Windows) : il affiche Service is running. Dans Status200, la Vue d'ensemble du moniteur cesse d'afficher les commandes de configuration dès que le premier rapport arrive, et son onglet Métriques commence à tracer le serveur.

Référence de l'agent#

Commandes#

Exécutez-les avec sudo sous Linux et macOS, et depuis une Invite de commandes ouverte en tant qu'administrateur sous Windows. Pour changer la clé secrète, l'URL ou le proxy d'un agent configuré, exécutez stop et uninstall, puis de nouveau configure et start.

Fichiers#

Quand l'agent ne peut pas écrire dans ces répertoires, il utilise ~/.oneuptime-infrastructure-agent/ à la place. Les variables d'environnement STATUS200_AGENT_CONFIG_PATH et STATUS200_AGENT_LOG_PATH définissent explicitement l'un ou l'autre chemin.

Mises à jour et désinstallation#

Mettez l'agent à jour de la façon dont vous l'avez installé :

Une mise à jour ne redémarre pas l'agent en cours d'exécution : lancez restart ensuite. Sous Windows, lancez stop avant winget upgrade et start après : winget ne peut pas remplacer le programme tant que le service l'exécute.

Pour supprimer l'agent, lancez d'abord uninstall, puis supprimez le paquet avec l'outil qui l'a installé, par exemple sudo apt-get remove oneuptime-infrastructure-agent.

Ce que remonte l'agent#

Chaque rapport contient le nom d'hôte du serveur et :

Les valeurs que le système d'exploitation ne fournit pas sont omises. L'onglet Métriques du moniteur trace la disponibilité, le CPU, la mémoire, l'utilisation et les E/S des disques, les charges moyennes, le swap, le trafic et les erreurs réseau, les connexions, la durée de fonctionnement et le nombre de processus.

Critères de surveillance#

Les critères décident quand le moniteur est en ligne, dégradé ou hors ligne, et quand il ouvre une alerte ou un incident. Chaque filtre d'un critère a un Type de filtre, une Condition de filtre et, pour la plupart des types, une valeur.

Chemin du disque accepte un point de montage ou un périphérique, comme /, /mnt/data, C:\ ou /dev/sda1 ; laissé vide, il vaut /. Saisissez * pour vérifier chaque disque que l'agent remonte : chaque disque qui dépasse le seuil reçoit sa propre alerte, si bien qu'un deuxième disque qui se remplit n'est pas caché derrière l'alerte ouverte du premier.

Évaluer sur une période#

Évaluer ce critère sur une période donnée est une case à cocher distincte dans le formulaire de critère, et non une condition de filtre. Elle est disponible pour Is Online et pour chaque type de filtre numérique. Cochez-la pour comparer un agrégat – choisi sous Évaluer (Moyenne, Somme, Maximum Value, Minimum Value, All Values, Any Value) sur la fenêtre définie par Pour les dernières (en minutes) – au lieu de la valeur de la dernière vérification. Sur un filtre Is Online, la fenêtre est la durée pendant laquelle l'agent peut rester silencieux avant que le serveur soit considéré hors ligne.

All Values ne correspond qu'une fois la fenêtre réellement couverte par des données. Un moniteur qui vient d'être créé, ou dont les vérifications ont cessé d'être enregistrées, n'a pas assez d'historique pour dire quoi que ce soit des N dernières minutes ; le critère attend donc au lieu de correspondre sur la seule mesure dont il dispose. Any Value est le réglage pour « prévenez-moi dès qu'une seule vérification dépasse » et se déclenche toujours immédiatement.

En l'absence de données contrôle ce qui se passe tant que la fenêtre ne peut pas étayer le critère :

Exemples de critères#

Dépannage#

curl -sSL https://status200.ru/docs/static/scripts/infrastructure-agent/install.sh | sudo bash -s -- -b /usr/local/bin

Étapes suivantes#