Aller au contenu principal

Installer l'es 'agent sur un serveur statique

Pour envoyer des informations système à Experience Monitoring, vous devez installer l’agent Experience Monitoring sur tous les serveurs que vous souhaitez superviser.

  • L’agent est uniquement compatible avec Linux.
  • Cette procédure peut être utilisée telle quelle si votre application ou votre site est hébergé sur un serveur statique. Pour les environnements en autoscaling (y compris Docker), elle doit être adaptée afin de gérer correctement l’hostid. Voir Installer l’agent dans des environnements en autoscaling.

Compatibilité​

  • Debian 10, 11, 12
  • Ubuntu Jammy, Kinetic, Lunar
  • CentOS 7, CentOS 8 Stream

Prérequis​

  • Pour installer l’agent Experience Monitoring, vous aurez besoin d’un jeton d’enregistrement automatique. Chaque site dispose de son propre jeton. Pour récupérer un jeton, rendez-vous dans le site de votre choix, puis accédez à Paramètres > Système. Le jeton s’affiche dans une case verte.

  • Les agents système doivent pouvoir communiquer avec notre infrastructure. Vous devrez peut-être ajouter nos adresses IP à la liste blanche.

  • Pour ajouter, modifier ou supprimer un serveur dans Experience Monitoring, vous devez disposer des droits Admin ou Propriétaire au sein de votre organisation. Demandez à votre administrateur ou au service d'assistance de vous attribuer les droits appropriés.

Procédure d'installation​

  1. Ajoutez la ligne suivante au fichier /etc/apt/sources.list.d/quanta.list.

    deb [signed-by=/usr/share/keyrings/quanta-archive-keyring.pgp] http://apt.quanta.io/debian buster main

    Si vous n'êtes pas sûr de la version de Debian que vous utilisez, vous pouvez consulter le fichier /etc/debian_version.

  2. Téléchargez et ajoutez la clé GPG de notre dépôt :

    curl https://apt.quanta.io/quanta-repo-key.gpg | gpg -o /usr/share/keyrings/quanta-archive-keyring.pgp --dearmor

  3. Mettez à jour la liste des paquets :

    apt update

  4. Installez l’agent :

    apt install quanta-agent

    Le système vous demandera le jeton lors de l’installation, et les données système devraient apparaître dans Experience Monitoring en moins d’une minute. Vous pouvez ensuite installer les agents d’application si vous en avez besoin.

Dépannage de l'installation de l'agent​

Je ne vois pas de données arriver, où puis-je trouver des informations pour dépanner ?

L’agent utilise syslog pour la journalisation ; vous trouverez généralement les logs dans /var/log/daemon.log ou /var/log/syslog. Si vous ne parvenez pas à identifier la source de l’erreur, veuillez contacter le support Centreon.

Vous pouvez rediriger les journaux vers un autre fichier en modifiant la variable file dans la section logger du fichier /etc/quanta/agent.yml (veillez à configurer la rotation des logs).

Modification d'une installation existante​

Si vous souhaitez modifier la configuration d'un agent Experience Monitoring déjà installé sur l'un de vos serveurs, vous trouverez ses paramètres dans le fichier /etc/quanta/agent.yml. Ce fichier contient les principales informations de connexion, notamment le jeton Experience Monitoring correspondant au site concerné. L'accès à ce fichier peut s'avérer utile si vous supervisez plusieurs sites avec le même compte Experience Monitoring et que vous souhaitez spécifier le jeton approprié pour associer chaque serveur au site qu'il héberge (par exemple, pour distinguer les serveurs de production des serveurs de préproduction).

Voici un extrait du fichier /etc/quanta/agent.yml :

user: quanta-agent
directory: /var/run/quanta
pidfile: /var/run/quanta/agent.pid
daemonize: yes

poll_interval: 60
update_interval: 15

logger:
  level: notice
  file: syslog

hostid: [...] <- identifiant du serveur, généré automatiquement lors de l’installation
quanta_token: [...] <- insérez ici le jeton correspondant à votre site

[...]

Adresses des endpoints pour les agents serveur​

Si vous utilisez l'agent Experience Monitoring, chacun de vos serveurs envoie régulièrement des données (une fois par minute) au service Experience Monitoring.

Il s'agit d'un trafic HTTPS sortant (port 443) qui est souvent autorisé par défaut. Toutefois, si vos règles de pare-feu sont strictes et que vous devez autoriser des destinations spécifiques pour Experience Monitoring, ajoutez les adresses IP de destination suivantes à la liste :

  • 52.215.166.110
  • 52.215.179.235
  • 52.215.180.115