Documentation
Table of Contents
2 Enregistrement automatique d'agent actif
Aper?u
Il est possible d'autoriser l'enregistrement automatique d'agents Áú»¢¶Ä²© actifs, apr¨¨s quoi le serveur pourra commencer ¨¤ les surveiller. De cette fa?on, de nouveaux h?tes peuvent ¨ºtre ajout¨¦s pour la surveillance sans les configurer manuellement sur le serveur.
L'enregistrement automatique peut se produire lorsqu'un agent actif pr¨¦c¨¦demment inconnu demande des v¨¦rifications.
Cette fonctionnalit¨¦ peut s'av¨¦rer tr¨¨s pratique pour la supervision automatique de nouveaux n?uds Cloud. D¨¨s que vous avez un nouveau n?ud dans le cloud, Áú»¢¶Ä²© lance automatiquement la collecte des donn¨¦es de performance et de disponibilit¨¦ de l'h?te.
L'enregistrement automatique des agents actifs prend ¨¦galement en charge la surveillance des h?tes ajout¨¦s avec des v¨¦rifications passives. Lorsque l'agent actif demande des v¨¦rifications, ¨¤ condition qu'il dispose des param¨¨tres de configuration 'ListenIP' ou 'ListenPort' d¨¦finis dans le fichier de configuration, celles-ci sont envoy¨¦es au serveur. (Si plusieurs adresses IP sont sp¨¦cifi¨¦es, la premi¨¨re est envoy¨¦e au serveur.)
Le serveur, lors de l'ajout du nouvel h?te enregistr¨¦ automatiquement, utilise l'adresse IP et le port re?us pour configurer l'agent. Si aucune valeur d'adresse IP n'est re?ue, celle utilis¨¦e pour la connexion entrante est utilis¨¦e. Si aucune valeur de port n'est re?ue, 10050 est utilis¨¦.
Il est possible de sp¨¦cifier que l'h?te doit ¨ºtre enregistr¨¦ automatiquement avec un nom DNS comme interface d'agent par d¨¦faut.
L'enregistrement automatique est relanc¨¦ :
- si les ³¾±ð³Ù²¹»å´Ç²Ô²Ô¨¦±ð²õ de l'h?te changent :
- en raison de la modification de HostMetadata et du red¨¦marrage de l'agent
- en raison de la valeur modifi¨¦e renvoy¨¦e par HostMetadataItem
- pour les h?tes cr¨¦¨¦s manuellement avec des m¨¦tadonn¨¦es manquantes
- si un h?te est modifi¨¦ manuellement pour ¨ºtre surveill¨¦ par un autre proxy Áú»¢¶Ä²©
- si l'enregistrement automatique pour le m¨ºme h?te provient d'un nouveau proxy Áú»¢¶Ä²©
Configuration
Sp¨¦cification du serveur
Assurez-vous que le serveur Áú»¢¶Ä²© est identifi¨¦ dans le?fichier de configuration?de l'agent - zabbix_agentd.conf.
ServerActive=10.0.0.1Sauf si vous d¨¦finissez sp¨¦cifiquement un?Hostname?dans zabbix_agentd.conf, le nom d'h?te syst¨¨me de l'agent sera utilis¨¦ par le serveur pour nommer l'h?te. Le nom d'h?te syst¨¨me sous Linux peut ¨ºtre obtenu en ex¨¦cutant la commande 'hostname'.
Red¨¦marrez l'agent apr¨¨s avoir apport¨¦ des modifications au fichier de configuration.
Action pour l'enregistrement automatique de l'agent actif
Lorsque le serveur re?oit une demande d'enregistrement automatique d'un agent, il appelle une?action. Une action de la source d'¨¦v¨¦nement "Enregistrement automatique" doit ¨ºtre configur¨¦e pour l'enregistrement automatique de l'agent.
La configuration de la?d¨¦couverte du r¨¦seau?n'est pas obligatoire pour que les agents actifs soient automatiquement enregistr¨¦s.
Dans l'interface Áú»¢¶Ä²©, s¨¦lectionnez?Configuration ¡ú Actions, s¨¦lectionnez Enregistrement automatique?comme source d'¨¦v¨¦nement et cliquez sur?Cr¨¦er une action?:
- Dans l'onglet Action, donnez un nom ¨¤ votre action.
- Sp¨¦cifiez ¨¦ventuellement des conditions. Vous pouvez effectuer une correspondance de sous-cha?ne ou une correspondance d'expression r¨¦guli¨¨re dans les conditions pour le nom d'h?te/les m¨¦tadonn¨¦es d'h?te. Si vous envisagez d'utiliser la condition "M¨¦tadonn¨¦es de l'h?te", reportez-vous ¨¤ la section suivante.
- Dans l'onglet Op¨¦rations, ajoutez les op¨¦rations pertinentes, telles que - 'Ajouter h?te', 'Ajouter au groupe d'h?tes' (par exemple,?H?tes d¨¦couverts), 'Lier au mod¨¨le', etc.
Si les h?tes ¨¤ enregistrer automatiquement ne doivent ¨ºtre pris en charge que pour la surveillance active (tels que les h?tes prot¨¦g¨¦s par un pare-feu depuis votre serveur Áú»¢¶Ä²©), vous devriez peut-¨ºtre cr¨¦er un mod¨¨le sp¨¦cifique?Template_Linux-active?auquel les associer.
Les h?tes cr¨¦¨¦s sont ajout¨¦s au groupe?Discovered hosts?(par d¨¦faut, configurable dans?Administration?¡ú?³Ò¨¦²Ô¨¦°ù²¹±ô?¡ú?Autre). Si vous souhaitez que des h?tes soient ajout¨¦s ¨¤ un autre groupe, ajoutez une op¨¦ration?Supprimer du groupe d'h?tes?(en sp¨¦cifiant "Discovered hosts") et ajoutez ¨¦galement une op¨¦ration?Ajouter au groupe d'h?tes?(sp¨¦cifiant un autre groupe d'h?tes), car un h?te doit appartenir ¨¤ un groupe d'h?tes.
Enregistrement automatique s¨¦curis¨¦
Un moyen s¨¦curis¨¦ d'enregistrement automatique est possible en configurant l'authentification bas¨¦e sur PSK avec des connexions crypt¨¦es.
Le niveau de cryptage est configur¨¦ globalement dans Administration ¡ú ³Ò¨¦²Ô¨¦°ù²¹±ô, dans la section Enregistrement automatique accessible via le menu d¨¦roulant ¨¤ droite. Il est possible de ne s¨¦lectionner aucun cryptage, un cryptage TLS avec authentification PSK ou les deux (afin que certains h?tes puissent s'enregistrer sans cryptage tandis que d'autres par cryptage).
L'authentification par PSK est v¨¦rifi¨¦e par le serveur Áú»¢¶Ä²© avant d'ajouter un h?te. En cas de succ¨¨s, l'h?te est ajout¨¦ et Connexions depuis/vers l'h?te sont d¨¦finis sur 'PSK' uniquement avec l'identit¨¦/la cl¨¦ pr¨¦-partag¨¦e identique ¨¤ celle du param¨¨tre de l'enregistrement automatique global.
Pour garantir la s¨¦curit¨¦ de l'enregistrement automatique sur les installations utilisant des proxys, le chiffrement entre le serveur Áú»¢¶Ä²© et le proxy doit ¨ºtre activ¨¦.
Utiliser DNS comme interface par d¨¦faut
Les param¨¨tres de configuration HostInterface et HostInterfaceItem permettent de sp¨¦cifier une valeur personnalis¨¦e pour l'interface h?te lors de l'enregistrement automatique.
Plus pr¨¦cis¨¦ment, ils sont utiles si l'h?te doit ¨ºtre enregistr¨¦ automatiquement avec un nom DNS comme interface d'agent par d¨¦faut plut?t que son adresse IP. Dans ce cas, le nom DNS doit ¨ºtre sp¨¦cifi¨¦ ou renvoy¨¦ comme valeur des param¨¨tres HostInterface ou HostInterfaceItem. Notez que si la valeur de l'un des deux param¨¨tres change, l'interface h?te enregistr¨¦e automatiquement est mise ¨¤ jour. Il est donc possible de mettre ¨¤ jour l'interface par d¨¦faut vers un autre nom DNS ou de la mettre ¨¤ jour vers une adresse IP. Pour que les modifications prennent effet, l'agent doit ¨ºtre red¨¦marr¨¦.
Si les param¨¨tres HostInterface ou HostInterfaceItem ne sont pas configur¨¦s, le param¨¨tre listen_dns est r¨¦solu ¨¤ partir de l'adresse IP. Si une telle r¨¦solution n'est pas configur¨¦e correctement, elle peut interrompre l'enregistrement automatique en raison d'un nom d'h?te non valide.
Utilisation des m¨¦tadonn¨¦es de l'h?te
Lorsque l'agent envoie une demande d'enregistrement automatique au serveur, il envoie son nom d'h?te. Dans certains cas (par exemple, les n?uds Amazon cloud), un nom d¡¯h?te ne suffit pas au serveur Áú»¢¶Ä²© pour diff¨¦rencier les h?tes d¨¦couverts. Les m¨¦tadonn¨¦es de l'h?te peuvent ¨¦ventuellement ¨ºtre utilis¨¦es pour envoyer d'autres informations d'un agent au serveur.
Les m¨¦tadonn¨¦es de l'h?te sont configur¨¦es dans le?fichier de configuration?de l'agent - zabbix_agentd.conf. Il existe 2 fa?ons de sp¨¦cifier les m¨¦tadonn¨¦es de l'h?te dans le fichier de configuration :
HostMetadata
HostMetadataItemVoir la description des options dans le lien ci-dessus.
Une tentative d'enregistrement automatique se produit chaque fois qu'un agent actif envoie une demande d'actualisation des v¨¦rifications actives au serveur. Le d¨¦lai entre les demandes est sp¨¦cifi¨¦ dans le param¨¨tre?RefreshActiveChecks?de l'agent. La premi¨¨re demande est envoy¨¦e imm¨¦diatement apr¨¨s le red¨¦marrage de l'agent.
Exemple 1
Utilisation de m¨¦tadonn¨¦es d'h?te pour distinguer les h?tes Linux et Windows.
Supposons que vous souhaitiez que les h?tes soient automatiquement enregistr¨¦s par le serveur Áú»¢¶Ä²©. Vous avez des agents Áú»¢¶Ä²© actifs (voir la section "Configuration" ci-dessus) sur votre r¨¦seau. Il existe des h?tes Windows et des h?tes Linux sur votre r¨¦seau et vous avez des mod¨¨les "Template OS Linux" et "Template OS Windows" disponibles dans votre interface Áú»¢¶Ä²©. Ainsi, lors de l'enregistrement de l'h?te, vous souhaitez que le mod¨¨le Linux/Windows appropri¨¦ soit appliqu¨¦ ¨¤ l'h?te en cours d'enregistrement. Par d¨¦faut, seul le nom d'h?te est envoy¨¦ au serveur lors de l'enregistrement automatique, ce qui pourrait ne pas suffire. Afin de vous assurer que le mod¨¨le appropri¨¦ est appliqu¨¦ ¨¤ l'h?te, vous devez utiliser les m¨¦tadonn¨¦es de l'h?te.
Configuration de l'interface web
La premi¨¨re chose ¨¤ faire est de configurer l'interface web. Cr¨¦ez 2 actions.
La premi¨¨re action :
- Nom : Enregistrement automatique de l'h?te Linux
- Conditions : Les m¨¦tadonn¨¦es de l'h?te contiennent?Linux
- Op¨¦rations : Lier au mod¨¨le : Template OS Linux
Vous pouvez ignorer une op¨¦ration "Ajouter un h?te" dans ce cas. La liaison ¨¤ un mod¨¨le n¨¦cessite l'ajout pr¨¦alable d'un h?te afin que le serveur le fasse automatiquement.
La deuxi¨¨me action :
- Nom : Enregistrement automatique de l'h?te Windows
- Conditions : Les m¨¦tadonn¨¦es de l'h?te contiennent?Windows
- Op¨¦rations : Lier au mod¨¨le : Template OS Windows
Configuration de l'agent
Vous devez maintenant configurer les agents. Ajoutez la ligne suivante aux fichiers de configuration de l'agent :
HostMetadataItem=system.unameAinsi, vous vous assurez que les m¨¦tadonn¨¦es de l'h?te contiendront "Linux" ou "Windows" en fonction de l'h?te sur lequel un agent s'ex¨¦cute. Un exemple de m¨¦tadonn¨¦es h?te dans ce cas :
Linux : Linux server3 3.2.0-4-686-pae #1 SMP Debian 3.2.41-2 i686 GNU/LinuxWindows : Windows WIN-0PXGGSTYNHO 6.0.6001 Windows Server 2008 Service Pack 1 Intel IA-32N'oubliez pas de red¨¦marrer l'agent apr¨¨s avoir apport¨¦ des modifications au fichier de configuration.
Exemple 2
?tape 1
Utilisation de m¨¦tadonn¨¦es d¡¯h?te pour permettre une protection de base contre l¡¯enregistrement d¡¯h?tes ind¨¦sirables.
Configuration de l'interface web
Cr¨¦ez une action dans l'interface, en utilisant un code secret difficile ¨¤ deviner pour interdire les h?tes ind¨¦sirables :
- Nom : Action d'enregistrement automatique Linux
- Conditions:
* Type de calcul : AND
* Condition (A) : Les m¨¦tadonn¨¦es de l'h?te contiennent Linux
* Condition (B) : Les m¨¦tadonn¨¦es de l'h?te contiennent 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae
* Op¨¦rations :
* Envoyer un message aux utilisateurs : Admin via tous les m¨¦dias
* Ajouter au groupe d'h?tes : serveurs Linux
* Lier au mod¨¨le : Template OS LinuxVeuillez noter que cette m¨¦thode seule ne fournit pas une protection solide, car les donn¨¦es sont transmises en texte brut. Le rechargement du cache de configuration est requis pour que les modifications aient un effet imm¨¦diat.
Configuration de l'agent
Ajoutez la ligne suivante au fichier de configuration de l'agent :
HostMetadata=Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08aeo¨´ "Linux" est une plate-forme et le reste de la cha?ne est un texte secret difficile ¨¤ deviner.
N'oubliez pas de red¨¦marrer l'agent apr¨¨s avoir apport¨¦ des modifications au fichier de configuration.
?tape 2
Il est possible d'ajouter une surveillance suppl¨¦mentaire pour un h?te d¨¦j¨¤ enregistr¨¦.
Configuration de l'interface web
Mettez ¨¤ jour l'action dans l'interface Web :
- Nom : Auto registration action Linux
- Conditions :
* Type de calcul : AND
* Condition (A) : Les m¨¦tadonn¨¦es de l'h?te contiennent Linux
* Condition (B) : Les m¨¦tadonn¨¦es de l'h?te contiennent 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae
* Op¨¦rations :
* Envoyer un message aux utilisateurs : Admin via tous les m¨¦dias
* Ajouter au groupe d'h?tes : serveurs Linux
* Lier au mod¨¨le : Template OS Linux
* Lier au mod¨¨le : Template DB MySQLConfiguration de l'agent
Mettez ¨¤ jour la ligne suivante dans le fichier de configuration de l'agent :
HostMetadata=MySQL on Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08aeN'oubliez pas de red¨¦marrer l'agent apr¨¨s avoir apport¨¦ des modifications au fichier de configuration.