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.
  • Une configuration manuelle est Ă  rĂ©aliser. Dans la version dĂ©finitive, celle-ci sera possible via l'interface utilisateur, et largement automatisĂ©e.

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. Sur le collecteur qui recevra les données de l'agent, installez le paquet centreon-engine-opentelemetry.

  2. 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​

  • Installez le paquet centreon-monitoring-agent.
  1. Modifiez le fichier /etc/centreon-monitoring-agent/centagent.json local (4 cas) :
{
    "log_level":"trace",
    "endpoint":"<IP POLLER>:4317",
    "host":"host_1",
    "log_type":"file",
    "log_file":"/var/log/centreon-monitoring-agent/centagent.log" 
}

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: trace, debug, info, warning, error, critical et off.

  1. Redémarrer l'agent : 
    systemctl restart 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.

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.