Se rendre au contenu

3 façons d’ajouter un hôte dans Zabbix

Comment ajouter des hôtes dans Zabbix : Notre guide complet

Zabbix est une puissante plateforme de surveillance open-source qui permet aux administrateurs système de surveiller divers paramètres des réseaux, des serveurs et des applications. Ajouter des hôtes dans Zabbix est une étape cruciale pour commencer à surveiller votre infrastructure. 

Dans cet article, nous allons explorer les trois principales façons d'ajouter des hôtes dans Zabbix : via l'interface web, en utilisant des fichiers externe, en utilisant l'API de Zabbix,. et via l'auto-enregistrement des agents actifs.

1. Ajouter des hôtes via l'interface Web

C'est la méthode la plus intuitive, idéale pour tous.

Étapes :

  1. Connexion à Zabbix : connectez-vous à votre interface web Zabbix en utilisant vos identifiants administrateur.
  2. Accéder à la section "Configuration" ou "Data collection", puis "Hosts".
  3. Ajouter un nouvel hôte : cliquez sur le bouton "Create host".
  4. Configurer les détails de l'hôte :
    • Nom de l'Hôte : donnez un nom unique à l'hôte.
    • Nom Visible : (Optionnel) un nom technique alternatif qui sera affiché dans l'interface.
    • Groupes : ajoutez l'hôte à un ou plusieurs groupes pour une meilleure organisation.
    • Interfaces : définissez l'interface (agent Zabbix, SNMP, IPMI, JMX) par laquelle Zabbix collectera les données.
  5. Liens avec les Templates : associez l'hôte à un ou plusieurs templates.
  6. Enregistrer : Cliquez sur "Add" pour sauvegarder l'hôte.


2. Ajouter des hôtes via un fichier externe

Cette méthode est plus adaptée pour les déploiements massifs et les environnements automatisés.

Étapes :

  1. Créer un fichier de configuration : rédigez un fichier JSON, XML ou YAML avec les détails des hôtes. 

Voici un exemple en XML :

  1. <zabbix_export>
        <hosts>
            <host>
                <host>Host</host>
                <name>Host</name>
                <interfaces>
                    <interface>
                        <default>1</default>
                        <ip>192.168.1.1</ip>
                        <dns></dns>
                        <useip>1</useip>
                        <port>10050</port>
                        <type>1</type>
                    </interface>
                </interfaces>
                <groups>
                    <group>
                        <name>Linux servers</name>
                    </group>
                </groups>
                <templates>
                    <template>
                        <name>Linux by Zabbix agent</name>
                    </template>
                </templates>
            </host>
        </hosts>
    </zabbix_export>
    
  2. Importer le fichier dans Zabbix :
    • Allez dans "Configuration" ou "Data collection" puis "Hosts".
    • Cliquez sur le bouton "Import".
    • Importez votre fichier externe et suivez les instructions pour l'importer.

3. Ajouter des hôtes via l'API de Zabbix

Pour des intégrations avancées ou des automatisations, l'utilisation de l'API de Zabbix est idéale.

Étapes :

  1. Authentification : obtenez un token d'authentification en envoyant une requête JSON à l'API avec la méthode "user.login" ou via l'interface web depuis le menu "Users / API Tokens" :
    {
        "jsonrpc": "2.0",
        "method": "user.login",
        "params": {
            "username": "Admin",
            "password": "zabbix"
        },
        "id": 1,
        "auth": null
    }
    
  2. Créer un nouvel Hôte : utilisez le token obtenu pour ajouter un hôte en envoyant une requête au format JSON :
{
    "jsonrpc": "2.0",
    "method": "host.create",
    "params": {
        "host": "Host",
        "interfaces": [
            {
                "type": 1,
                "main": 1,
                "useip": 1,
                "ip": "192.168.1.1",
                "dns": "",
                "port": "10050"
            }
        ],
        "groups": [
            {
                "groupid": "1"
            }
        ],
        "templates": [
            {
                "templateid": "10001"
            }
        ]
    },
    "auth": "your_auth_token",
    "id": 1
}

Vous pouvez utiliser la librairie Python officielle de Zabbix zabbix-utils pour cela.

Lire l'article sur le Blog de Zabbix.


4. Bonus

Il existe une quatrième méthode qui est l'auto-enregistrement des agents actifs.

Cette méthode donnera lieu à un article dédié.


Conclusion

Ajouter des hôtes dans Zabbix est une étape essentielle pour surveiller efficacement votre infrastructure. Que vous préfériez une interface graphique conviviale, des fichiers externe pour des déploiements en masse, ou l'API pour des intégrations avancées, Zabbix offre une flexibilité pour répondre à vos besoins. En maîtrisant ces trois méthodes, vous pouvez adapter votre stratégie de surveillance IT à diverses situations et exigences.

Surveiller Docker avec Zabbix