Agents
Qu'est-ce qu'un Agent ServicePilot ?
Les Agents ServicePilot sont conçus pour collecter des données de supervision de différentes sources et les envoyer à ServicePilot. Les Agents ServicePilot ne nécessitent qu'une configuration succinte. Tout ce dont ils ont besoin, c'est d'un accès web à ServicePilot et d'une Clé API pour sécuriser la communication. Toute autre configuration se fait via l'interface web de ServicePilot.
Agents ServicePilot SaaS
Lorsqu'un Agent ServicePilot est déployé pour l'utiliser avec le SaaS ServicePilot, une connexion HTTPS est établie entre l'Agent ServicePilot et ServicePilot dans le Cloud. Un proxy Web peut être défini dans l'Agent Windows ServicePilot si nécessaire pour accéder à Internet.
Agents ServicePilot On Premise
Lorsqu'un Agent ServicePilot est déployé pour l'utiliser avec une installation de ServicePilot On Premise, le FQDN du Manager ServicePilot devra être configuré dans l'Agent. L'Agent communiquera avec le Manager ServicePilot par HTTP ou HTTPS.
Combien d'Agents ServicePilot doivent être installés ?
Il est toujours nécessaire d'avoir au moins un Agent ServicePilot, car la quasi-totalité de la collecte de données est effectuée par des agents. Le nombre d'agents requis dépend du type de supervision que l'on demande aux agents d'effectuer et si les agents peuvent accéder aux données requises. Les agents peuvent collecter des données à partir du serveur sur lequel ils sont installés. Certaines collectes de données ne peuvent être effectuées que sur le même hôte qu'un Agent ServicePilot.
Les agents peuvent également obtenir des données d'autres équipements et écouter les événements qui leur sont transmis, à condition que l'accès au réseau des autres équipements ne soit pas bloqué.
Pour savoir si un Agent ServicePilot doit être installé sur le même serveur que les données qu'il va collecter, consultez la colonne Collecte locale dans le tableau Licenses - Agent details, disponible dans l'interface web de ServicePilot.
| 1. En utilisant un compte avec des privilèges administrateurs, accédez à ServicePilot |
| 2. Cliquez sur Agents > Installer un agent |
| 3. Cliquez sur Agent Details |
Proxy d'Agent ServicePilot pour accéder à ServicePilot
Si les Agents ServicePilot ne sont pas autorisés à communiquer avec ServicePilot en raison de restrictions de pare-feu, un Proxy pour l'Agent ServicePilot peut être déployé. Ce proxy d'Agent ServicePilot servira de passerelle et de concentrateur entre les Agents ServicePilot et le Manager ServicePilot. Seul le proxy d'Agents ServicePilot doit avoir accès au Manager ServicePilot, tandis que les Agents ServicePilot seront configurés pour envoyer du trafic au proxy. Du point de vue de la sécurité, cette configuration peut être préférable, mais il faut noter qu'elle introduit un nouveau point de défaillance possible.
Veuillez contacter notre support ServicePilot si vous souhaitez configurer un proxy pour l'Agent ServicePilot.
Capacités de collectes de l'Agent ServicePilot
Chaque Agent ServicePilot possède des capacités de collectes différentes. Pour voir ce que ces Agents Enterprise peuvent faire, consultez la page Agent Details :
| 1. En utilisant un compte avec des privilèges administrateurs, accédez à ServicePilot |
| 2. Cliquez sur Agents > Installer un agent |
| 3. Cliquez sur le bouton Agent Details |
Agents Enterprise ServicePilot
Les Agents Enterprise collectent des données directement sur les serveurs où ils sont installés, ou sur d'autres équipements. Ces agents peuvent aussi recevoir des données d'événements non sollicités s'ils sont configurés pour le faire.
L'Agent Windows ServicePilot utilise le framework .NET de Microsoft.
L'Agent Linux ServicePilot a été compilé pour les distributions x86 et x64 basées sur RedHat et Debian actuellement supportées, ainsi que pour l'OS Raspberry Pi 32-bit sur ARM.
Agent Endpoint ServicePilot
L'Agent Endpoint ServicePilot est conçu pour collecter l'inventaire matériel et logiciel des postes de travail Windows.
Agent Developer ServicePilot
Des données statistiques sur le nombre et le type d'appels Web effectués dans les applications Puppeteer, JavaScript dans les navigateurs Web et Node.js peuvent être collectées. Ces intégrations nécessitent d'instrumenter le code en question pour envoyer les détails des appels à ServicePilot.
Intégration de l'Agent Open Source
L'Agent Windows ServicePilot peut agir comme une passerelle vers un certain nombre d'Agents Open Source, fournissant ainsi à ServicePilot les données collectées par ces agents.
Status Monitor de ServicePilot
Le Status Monitor de ServicePilot n'est pas un agent utilisé pour collecter des données. Il s'agit d'une extension de l'interface web de ServicePilot permettant aux utilisateurs de ServicePilot de voir le nombre actuel d'éléments avec des alertes sur le bureau de Windows.
Le Status Monitor de ServicePilot peut être téléchargé depuis le menu Utilisateur.
Télécharger les Agents ServicePilot
| 1. En utilisant un compte avec des privilèges administrateurs, accédez à ServicePilot |
| 2. Cliquez sur Agents > Installer un agent |
| 3. Sélectionnez l'Agent à installer et suivez les instructions sous Commencer |
Obtenir une clé API ServicePilot
Les Agents ServicePilot communiquent avec ServicePilot à l'aide d'une Clé API. Plusieurs clés API peuvent être créées et utilisées, mais chaque Agent doit être configuré avec une clé API valide avec droit d'écriture. Pour voir les clés API qui peuvent être utilisées, accédez à la page Clés :
| 1. En utilisant un compte avec des privilèges administrateurs, accédez à ServicePilot |
| 2. Ouvrez PARAMETRES > Configuration |
| 3. Cliquez sur Clés API |
| 4. Récupérez une clé API avec autorisation Écrire |
Installer un Agent Windows ServicePilot
Après avoir téléchargé l'Agent ServicePilot, double-cliquez sur le fichier pour exécuter le programme d'installation. A la fin de l'installation, la console de configuration de ServicePilot s'ouvre. Définissez les paramètres pour que l'Agent ServicePilot puisse communiquer avec ServicePilot, puis démarrez l'Agent. La console peut être fermée une fois que l'Agent communique correctement avec ServicePilot.
| Paramètre | Description |
|---|---|
| Clé API | Une clé API autorisée en écriture telle qu'elle se trouve dans la liste des clés API listées ci-dessus |
| Remote Command | Ne pas activer ce paramètre à moins qu'une ressource supervisée ne le nécessite. Les descriptions des packages indiqueront quand ceci est nécessaire |
| Paramètre | Description |
|---|---|
| Use proxy | Si l'accès à ServicePilot nécessite un proxy Web, activez cette option et remplissez les champs Address et Port |
| Address | Spécifiez l'adresse IP du proxy |
| Port | Spécifiez le port du proxy |
| Username | Spécifiez un nom d'utilisateur pour autoriser l'accès par proxy, si nécessaire |
| Password | Spécifiez un mot de passe pour permettre l'accès par proxy, si nécessaire |
| Use SP proxy | Si l'accès à ServicePilot nécessite un proxy ServicePilot, activez cette option et remplissez le champ URL du proxy |
| URL | Spécifiez l'URL d'un proxy ServicePilot accessible |
Installer un Agent Linux ServicePilot
Après avoir téléchargé l'Agent ServicePilot, vérifiez que le fichier est exécutable puis lancez-le en tant que root. A la fin de l'installation, le script demandera une clé API. Définissez les paramètres pour que l'Agent ServicePilot puisse communiquer avec ServicePilot. Vous pouvez arrêter et démarrer le service spagent en utilisant les commandes standards de votre distribution Linux.
Pour x86, le fichier s'appelle
servicepilotlinuxagent.run
Pour ARM, le fichier s'appelleservicepilotlinuxarmagent.run
# chmod +x servicepilotlinuxagent.run
# ./servicepilotlinuxagent.run
Creating directory _agent_files
Verifying archive integrity... 100% All good.
Uncompressing ServicePilot Linux Agent Package 100%
spagent install script running
No configuration found, awaiting input
Enter API KEY
10000000-0000-0000-0000-000000000000
Use web proxy? [default: n]
n
Use ServicePilot proxy? [default: n]
n
Run in debug mode? [default: n]
n
Enter ServicePilot Agent Log Path [default: '/var/log/servicepilot/']
/var/log/servicepilot/
This is debian based distro
Removing spagent files
Removing dotnetcoreagent files
Reset spagent
Created symlink /etc/systemd/system/multi-user.target.wants/spagent.service → /etc/systemd/system/spagent.service.
spagent started
#
Pour obtenir la liste complète des paramètres de la ligne de commande, exécutez le programme d'installation avec l'option -- --help.
| 1. Aide de l'Agent Linux ServicePilot | ./servicepilotlinuxagent.run -- --help |
Vérifiez si un Agent ServicePilot fonctionne
Pour vous assurer que les Agents ServicePilot communiquent correctement avec ServicePilot, ouvrez la page Agents :
| 1. En utilisant un compte avec des privilèges administrateurs, accédez à ServicePilot |
| 2. Ouvrez PARAMETRES > Agents |
| 3. L'agent devrait apparaître dans la liste avec un statut jaune ou vert et une valeur dernière vue dans quelques secondes. Un statut jaune indique que l'agent n'a encore rien reçu à faire. |
Logs des Agents ServicePilot
Les logs des Agents ServicePilot journalisent les erreurs de connectivité entre l'Agent ServicePilot et ServicePilot, et les problèmes de récupération des données depuis les équipements. Ces logs d'Agents sont particulièrement intéressantes si la supervision ne semble pas fonctionner entre l'Agent et les équipements distants en raison de mauvaises informations d'accès.
Ouvrez les logs de l'Agents avec un éditeur de texte :
Logs de l'Agent Windows
C:\Program Files (x86)\ServicePilot\ServicePilot ISM Enterprise\Logs\ServicePilotAgent.log
Logs de l'Agent Linux
/var/log/servicepilot/servicepilotagent.log
/var/log/servicepilot/spgoagent.log
Désinstaller un Agent ServicePilot
Si un Agent ServicePilot n'est plus utilisé, il peut être désinstallé.
Vérifier si un Agent est en cours d'utilisation
| 1. En utilisant un compte avec des privilèges administrateurs, accédez à ServicePilot |
| 2. Ouvrez PARAMETRES > Agents |
| 3. Si un Agent n'est pas utilisé, le statut est jaune, ce qui signifie qu'il n'est pas configuré. Si l'Agent est toujours utilisé, en cliquant sur la loupe bleue, les Détails de l'Agent y compris le Agent data seront affichés. Cela va lister les ressources qui utilisent actuellement cet Agent. |
Désinstaller un Agent Windows ServicePilot
Pour désinstaller un Agent Windows ServicePilot correctement, vérifiez qu'il est arrêté avant de le supprimer.
| 1. Arrêtez le service ServicePilotAgent |
| 2. Fermez la ServicePilot Setup Console si elle est ouverte. |
| 3. Désinstallez l'Agent ServicePilot à partir du panneau de configuration de Windows. |
4. Optionnel : vous pouvez supprimer le répertoire C:\Program Files (x86)\ServicePilot si vous ne souhaitez pas conserver les logs de l'Agent |
5. Optionnel : si vous n'envisagez pas de réinstaller un Agent ServicePilot sur la machine, vous pouvez supprimer la clé de registre HKEY_LOCAL_MACHINE\SOFTWARE\ServicePilot Technologies |
Désinstaller un Agent Linux ServicePilot
S'assurer que l'Agent Linux ServicePilot n'est pas utilisé avant de le désinstaller.
| 1. Désinstallez l'Agent Linux ServicePilot | ./servicepilotlinuxagent.run -- --uninstall |
Supprimer les Agents désinstallés de la liste des Agents
Tant qu'un Agent n'est pas désinstallé, sa suppression de la liste des Agents n'aura pas l'effet souhaité car l'Agent continuera à communiquer avec ServicePilot et réapparaîtra continuellement dans la liste des Agents.
| 1. En utilisant un compte avec des privilèges administrateurs, accédez à ServicePilot |
| 2. Ouvrez PARAMETRES > Agents |
| 3. Cliquez sur l'icône corbeille orange puis sur le bouton Supprimer pour supprimer un Agent de la liste des Agents. |
Installation gratuite en quelques clics
