Service
Installer l'agent sous macOS

Installer l'agent sous macOS

Installez l'agent de supervision Logiserv sur un Mac Apple Silicon en un clic (installateur signé et notarisé par Apple) ou en une commande Terminal, vérifiez qu'il remonte ses données et corrigez les erreurs les plus courantes.

Vue d'ensemble

L'agent est le petit service qui collecte les mesures de votre Mac (processeur, mémoire, disques, réseau) et les envoie au serveur de supervision Logiserv. Sous macOS, Logiserv installe Zabbix Agent, le paquet officiel publié et signé par Zabbix SIA, déjà configuré pour votre parc.

Sur le Mac que vous utilisez, l'installation tient en un clic : un installateur Logiserv signé et notarisé par Apple, qui s'ouvre comme n'importe quelle application. Pour un autre Mac, une seule commande à coller dans Terminal. Comptez une à deux minutes.

✅ Avant de commencer

  • Un compte Logiserv, en période d'essai ou abonné. Votre parc est créé automatiquement à la première installation : rien à renseigner avant.
  • Un Mac Apple Silicon (M1 et suivants). Zabbix ne publie plus d'agent macOS pour les Mac Intel.
  • Le mot de passe d'un compte administrateur du Mac.
  • Un accès sortant vers zabbix.logiserv.re sur le port 10051/TCP. C'est autorisé par défaut sur la plupart des réseaux.

Aucun port entrant n'est à ouvrir : c'est l'agent qui contacte le serveur Logiserv, jamais l'inverse. Aucun de vos fichiers n'est lu.

🖱️ Sur ce Mac : en un clic

Télécharger l'installateur

Sur le Mac à superviser, ouvrez la page Démarrage (vous y arrivez directement après l'inscription), ou la page Agents pour un système supplémentaire. L'onglet macOS est choisi automatiquement.

Si votre parc compte des clients (offre Business), choisissez d'abord le client concerné dans la liste : le Mac sera rangé directement chez lui.

Cliquez sur Installer sur ce Mac (ou Télécharger l'installateur macOS sur la page Agents). Le bouton devient Installateur téléchargé et la page rappelle les étapes suivantes.

Cliquez pour agrandir

Ouvrir le paquet

Ouvrez le fichier téléchargé Logiserv-Agent-….pkg, dans le dossier Téléchargements. Ne le renommez pas : son nom porte votre code d'installation personnel, valable une heure.

Cliquez pour agrandir

Cliquez sur Continuer, puis Installer (installation pour tous les utilisateurs de l'ordinateur, sur le disque principal : laissez les choix proposés).

Autoriser l'installation

macOS demande le mot de passe d'un administrateur du Mac. Saisissez-le, puis cliquez sur Installer le logiciel.

Cliquez pour agrandir

Laisser l'agent finir

L'installateur affiche « L'installation a été réalisée avec succès » : l'agent termine sa configuration en arrière-plan, vous pouvez cliquer sur Fermer. Si macOS propose de placer le programme d'installation dans la corbeille, acceptez : il ne sert plus. L'installateur a aussi ajouté l'application Désinstaller Logiserv au dossier Applications, pour retirer l'agent plus tard.

Cliquez pour agrandir

Moins d'une minute plus tard, macOS affiche la notification « Activité des apps en arrière-plan » : un logiciel de « ZABBIX SIA » peut s'exécuter en arrière-plan. C'est l'agent qui démarre : rien à faire.

Cliquez pour agrandir

Vérifier sur la page Démarrage

De retour dans Safari, la page Démarrage confirme la connexion : C'est parti ! Cliquez sur Ouvrir mon tableau de bord ; les premières mesures arrivent en quelques minutes.

Cliquez pour agrandir

Ne désactivez pas « ZABBIX SIA » dans Réglages Système → Général → Ouverture et extensions : l'agent s'arrêterait et le Mac apparaîtrait hors ligne.

⌨️ Sur un autre Mac : par commande

Pour un Mac à distance, inutile d'ouvrir Logiserv dessus : copiez la commande depuis la page Démarrage ou Agents et collez-la sur place, ou transmettez-la à la personne qui l'administre.

Copier la commande

Cliquez sur Copier la commande Terminal. Un lien personnel et signé est généré à ce moment-là. Il est valable une heure et lié à votre parc : ne le partagez pas publiquement.

Lancer la commande dans Terminal

Sur le Mac à superviser, ouvrez Terminal (Finder → Applications → Utilitaires), collez la commande, de la forme suivante, puis appuyez sur Entrée et saisissez le mot de passe du Mac :

curl -sSL "https://logiserv.app/api/agent-script/macos?token=..." | sudo bash

🔍 Vérifier que tout fonctionne

La page Démarrage confirme elle-même la connexion. Pour vérifier à la main, ouvrez Terminal et contrôlez que le service de l'agent est chargé :

sudo launchctl list | grep -i zabbix

Une ligne contenant zabbix_agentd doit s'afficher.

Ouvrez ensuite la page Parc de Logiserv : le Mac y apparaît sous son nom en quelques minutes. Les premières valeurs arrivent tout de suite ; les graphiques sur plusieurs jours se remplissent au bout d'environ une heure.

🛠️ Problèmes fréquents

Le Mac n'apparaît pas après l'installation

Consultez le journal de l'installateur, qui indique l'étape en échec :

cat /var/log/logiserv-agent-install.log

« Code d'installation absent du nom du paquet »

Le fichier a été renommé (ou téléchargé deux fois, avec un nom modifié par le navigateur au-delà de « (1) »). Téléchargez un nouvel installateur depuis la page Démarrage et ouvrez-le tel quel.

Le lien a expiré (erreur 401)

L'installateur et la commande ne sont valables qu'une heure. Téléchargez un nouvel installateur, ou cliquez de nouveau sur Copier la commande Terminal.

Le serveur de supervision est injoignable

Testez l'accès depuis le Mac :

nc -vz zabbix.logiserv.re 10051

Si la connexion échoue, un pare-feu filtre le trafic sortant. Demandez l'ouverture de cette seule destination : zabbix.logiserv.re, port 10051/TCP, en sortie.

🔄 Mettre à jour ou réinstaller

Relancez simplement l'installateur ou la commande : l'agent déjà présent est remplacé par la dernière version et reçoit une nouvelle clé de chiffrement, sans créer de doublon dans votre parc ni perdre son historique. La page affiche alors Système déjà supervisé. La supervision s'interrompt environ une minute, le temps du redémarrage.

Le Mac est reconnu par son nom : s'il a été renommé entre-temps, il apparaîtra comme un nouveau système, et l'ancien restera hors ligne dans la page Parc, d'où vous pourrez le supprimer.

🗑️ Désinstaller l'agent

Relancer une désinstallation sur un Mac déjà nettoyé est sans effet et sans erreur.

Sur ce Mac : l'application « Désinstaller Logiserv »

Ouvrir l'application

L'installation a déposé Désinstaller Logiserv dans le dossier Applications. Elle est signée et notarisée par Apple, ne contacte pas Logiserv et fonctionne même après la fin de votre abonnement. Deux façons de l'ouvrir :

  • depuis Logiserv : page Agents, carte Désinstaller l'agent, onglet macOS, bouton Désinstaller de ce Mac. Safari demande s'il peut ouvrir « Désinstaller Logiserv » : cliquez sur Autoriser ;
  • depuis le Mac : Finder → Applications, le Launchpad ou Spotlight (Cmd + Espace, puis « Désinstaller »).

Si rien ne s'ouvre (application supprimée), cliquez sur Télécharger le désinstalleur, sous le bouton. Safari télécharge Desinstaller-Logiserv.zip et le décompresse : ouvrez Désinstaller Logiserv dans le dossier Téléchargements. À la première ouverture, macOS rappelle qu'il s'agit d'une app téléchargée d'Internet, vérifiée par Apple : cliquez sur Ouvrir.

Cliquez pour agrandir

Confirmer la désinstallation

L'application rappelle ce qui va être supprimé. Cliquez sur Désinstaller, puis saisissez le mot de passe du Mac et cliquez sur OK.

Cliquez pour agrandir

Cliquez pour agrandir

C'est terminé

L'application confirme : Agent désinstallé et Mac retiré de votre parc Logiserv. Le Mac disparaît de la page Parc et n'est plus facturé : il n'y a plus rien à faire. L'application se retire elle-même du dossier Applications ; une copie téléchargée peut être placée dans la corbeille avec son fichier .zip.

Si le site n'a pas pu être joint (pas de connexion, ou Mac installé avant novembre 2026), l'application affiche Agent désinstallé avec un bouton Ouvrir la page Parc : supprimez-y le Mac, sinon il y apparaîtra hors ligne.

Cliquez pour agrandir

Sur un autre Mac : par commande

Collez la commande dans Terminal :

curl -sSL "https://www.logiserv.app/api/agent-uninstall/macos" | sudo bash

L'agent, sa configuration, sa clé de chiffrement, ses journaux et le compte système zabbix sont supprimés ; vos fichiers ne sont pas touchés. Le Mac est ensuite retiré de votre parc automatiquement ; le script affiche Systeme retire de votre parc Logiserv, ou à défaut vous rappelle de le supprimer depuis la page Parc.

📚 Pour aller plus loin

Partagez ce lien