Aller au contenu principal

Centreon Monitoring Agent

Introduction​

L'Agent de supervision Centreon (Centreon Monitoring Agent, CMA) collecte des métriques et calcule des statuts sur les serveurs qu'il supervise, et les envoie à Centreon. Les plugins Centreon comme les plugins personnalisés basés sur Nagios sont compatibles avec l'agent.

Limitations​

L'Agent de supervision Centreon est en phase Beta. Les limitations suivantes s'appliquent :

  • Le pĂ©rimètre de supervision supportĂ© est limitĂ©, de nouveaux contrĂ´les (natifs) seront apportĂ©s dans la version dĂ©finitive.

OS supportés​

L'agent peut être installé sur et superviser les OS suivants :

  • Alma 8
  • Alma 9
  • Debian 11
  • Debian 12
  • Ubuntu 22.04 LTS

Étape 1: Configurez Centreon​

Installez le connecteur de supervision​

  1. Sur votre serveur central, allez Ă  la page Configuration > Gestionnaire de connecteurs de supervision.
  2. Installez le connecteur de supervision Linux Centreon Monitoring Agent.

Créez le connecteur Centreon Monitoring Agent​

Sur votre serveur central :

  1. Allez Ă  la page Configuration > Commandes > Connecteurs.
  2. Créez un nouveau connecteur avec les données suivantes :
ParamètreValeur
Nom du connecteurCentreon Monitoring Agent
Description du connecteurCentreon Monitoring Agent
Ligne de commandeopentelemetry --processor=centreon_agent --extractor=attributes --host_path=resource_metrics.resource.attributes.host.name --service_path=resource_metrics.resource.attributes.service.name
Utilisé par la commandeEntrez Centreon-Monitoring-Agent et cliquez sur Sélectionner tout
Statut du connecteurActivé

Configurez Engine​

  1. Configurez la communication entre le collecteur et l'agent :
  • Certains agents peuvent se connecter au collecteur, mais le collecteur peut Ă©galement se connecter Ă  certains agents.
  • Vous pouvez sĂ©lectionner plusieurs pollers Ă  la fois dans un mĂŞme formulaire de configuration afin d'Ă©viter d'effectuer plusieurs fois la mĂŞme configuration.
  1. Allez Ă  la page Configuration > Collecteurs > Configurations d'agent, puis cliquez sur Ajouter une configuration collecteur/agent.
  2. Dans la fenêtre qui s'ouvre, sélectionnez le type d'agent souhaité. Des champs supplémentaires apparaissent.
  3. Dans la section Paramètres, sélectionnez le ou les collecteurs qui recevront des données en provenance de l'agent.
  4. Dans la section Receveur OTLP, entrez les noms des fichiers des certificats pour la partie du collecteur (engine) qui recevra des données en provenance de l'agent. La communication entre l'agent et le collecteur se fait toujours en HTTPS. Vous devez mettre les certificats dans le répertoire /etc/pki/ du collecteur. Les fichiers doivent posséder l'extension .crt (pour les certificats) ou .key (pour la clé)
  1. Si l'agent n'est pas autorisé à se connecter au collecteur pour des raisons de sécurité (par exemple lorsque le collecteur est situé dans une DMZ), activez l'option Connection initiée par le collecteur. Puis, dans la section Configuration des hôtes, définissez tous les hôtes sur lesquels l'agent sera installé. Ici, les certificats sont optionnels, mais si vous les utilisez, mettez-les dans le répertoire /etc/pki/ du collecteur.

Si vous configurez plusieurs collecteurs en mĂŞme temps, assurez-vous que tous les fichiers de certificat aient le mĂŞme nom.

  1. Exportez la configuration.

  2. Redémarrez le moteur de collecte.

    systemctl restart centengine

L'Agent de supervision Centreon est maintenant capable de communiquer avec Centreon. Vous pouvez mettre vos hĂ´tes en supervision.

Étape 2 : Préparez l'hôte​

Téléchargez et installez l'agent sur l'hôte​

Dépôt Centreon et installation de l'agent​

Installez le dépôt Centreon puis l'agent à l'aide des commandes suivantes :

dnf install -y dnf-plugins-core
dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/24.10/el8/centreon-24.10.repo
dnf install  centreon-monitoring-agent
  • Configurez le centreon-monitoring-agent.
  1. Modifiez le fichier /etc/centreon-monitoring-agent/centagent.json local (4 cas) :
{
  "log_level":"info",
  "endpoint":"<IP POLLER>:4317",
  "host":"host_1",
  "log_type":"file",
  "log_file":"/var/log/centreon-monitoring-agent/centagent.log" 
}

Dans le champ host, entrez le nom de l'hĂ´te Ă  superviser tel que vous l'avez saisi dans l'interface Centreon. Si absent, l'agent utilisera le hostname de la machine.

Options de log​

Deux types de log sont disponibles :

  • file: l'agent loggue dans le fichier dont le chemin est donnĂ© par log_file.
  • stdout: l'agent loggue vers la sortie standard de l'exe.

Dans le cas de logging vers un fichier, une rotation peut être paramétrée avec les clés log_max_file_size et log_max_files.

Les niveaux de logs possibles sont:

  • off: aucun log
  • critical: erreurs critiques
  • error: toutes les erreurs
  • info: quelques informations supplĂ©mentaires
  • debug: quelques informations sur les connections en plus
  • trace: le niveau de trace le plus verbeux, permet de voir les messages Ă©changĂ©s avec le collecteur
  1. Redémarrer l'agent : 
    systemctl restart centagent

Vous pouvez vérifier l'état de l'agent avec la commande:

systemctl status centagent

Déployer les plugins Centreon sur l'hôte​

Les plugins Centreon exécuteront les contrôles sur l'hôte.

Activez les dépôts Centreon et installez le plugin​

Ce dépôt permettra d'installer les plugins Centreon ainsi que les dépendances qui ne peuvent pas être satisfaites par les dépôts standard des distributions.

dnf -y install dnf-plugins-core oracle-epel-release-el8
dnf config-manager --set-enabled ol8_codeready_builder

cat >/etc/yum.repos.d/centreon-plugins.repo <<'EOF'
[centreon-plugins-stable]
name=Centreon plugins repository.
baseurl=https://packages.centreon.com/rpm-plugins/el8/stable/$basearch/
enabled=1
gpgcheck=1
gpgkey=https://yum-gpg.centreon.com/RPM-GPG-KEY-CES
module_hotfixes=1

[centreon-plugins-stable-noarch]
name=Centreon plugins repository.
baseurl=https://packages.centreon.com/rpm-plugins/el8/stable/noarch/
enabled=1
gpgcheck=1
gpgkey=https://yum-gpg.centreon.com/RPM-GPG-KEY-CES
module_hotfixes=1

[centreon-plugins-testing]
name=Centreon plugins repository. (UNSUPPORTED)
baseurl=https://packages.centreon.com/rpm-plugins/el8/testing/$basearch/
enabled=0
gpgcheck=1
gpgkey=https://yum-gpg.centreon.com/RPM-GPG-KEY-CES
module_hotfixes=1

[centreon-plugins-testing-noarch]
name=Centreon plugins repository. (UNSUPPORTED)
baseurl=https://packages.centreon.com/rpm-plugins/el8/testing/noarch/
enabled=0
gpgcheck=1
gpgkey=https://yum-gpg.centreon.com/RPM-GPG-KEY-CES
module_hotfixes=1

[centreon-plugins-unstable]
name=Centreon plugins repository. (UNSUPPORTED)
baseurl=https://packages.centreon.com/rpm-plugins/el8/unstable/$basearch/
enabled=0
gpgcheck=1
gpgkey=https://yum-gpg.centreon.com/RPM-GPG-KEY-CES
module_hotfixes=1

[centreon-plugins-unstable-noarch]
name=Centreon plugins repository. (UNSUPPORTED)
baseurl=https://packages.centreon.com/rpm-plugins/el8/unstable/noarch/
enabled=0
gpgcheck=1
gpgkey=https://yum-gpg.centreon.com/RPM-GPG-KEY-CES
module_hotfixes=1
EOF

Installez le plugin :

dnf install -y centreon-plugin-Operatingsystems-Linux-Local.noarch

Étape 3 : Mettez l'hôte en supervision​

Créez l'hôte en utilisant le bon modèle​

Sur le serveur central, créez l'hôte et appliquez-lui le modèle d'hôte OS-Linux-Centreon-Monitoring-Agent-custom.