Sommaire

zabbix_sender

ZABBIX_SENDER(1)            Manuel des commandes générales           ZABBIX_SENDER(1)

NOM
       zabbix_sender - utilitaire d'envoi Zabbix

SYNOPSIS
       zabbix_sender [-v] -z serveur [-p port] [-I adresse-IP] [-t délai] -s
       hôte -k clé -o valeur
       zabbix_sender [-v] -z serveur [-p port] [-I adresse-IP] [-t délai] [-s
       hôte] [-T] [-N] [-r] -i fichier-d'entrée
       zabbix_sender [-v] -c fichier-de-configuration [-z serveur] [-p port] [-I adresse-IP]
       [-t délai] [-s hôte] -k clé -o valeur
       zabbix_sender [-v] -c fichier-de-configuration [-z serveur] [-p port] [-I adresse-IP]
       [-t délai] [-s hôte] [-T] [-N] [-r] -i fichier-d'entrée
       zabbix_sender [-v] -z serveur [-p port] [-I adresse-IP] [-t délai] -s
       hôte --tls-connect cert --tls-ca-file fichier-CA [--tls-crl-file fichier-CRL]
       [--tls-server-cert-issuer émetteur-du-certificat] [--tls-server-cert-subject
       sujet-du-certificat] --tls-cert-file fichier-de-certificat --tls-key-file fichier-de-clé
       [--tls-cipher13 chaîne-de-chiffrement] [--tls-cipher chaîne-de-chiffrement] -k clé -o
       valeur
       zabbix_sender [-v] -z serveur [-p port] [-I adresse-IP] [-t délai] [-s
       hôte] --tls-connect cert --tls-ca-file fichier-CA [--tls-crl-file
       fichier-CRL] [--tls-server-cert-issuer émetteur-du-certificat]
       [--tls-server-cert-subject sujet-du-certificat] --tls-cert-file fichier-de-certificat
       --tls-key-file fichier-de-clé [--tls-cipher13 chaîne-de-chiffrement] [--tls-cipher
       chaîne-de-chiffrement] [-T] [-N] [-r] -i fichier-d'entrée
       zabbix_sender [-v] -c fichier-de-configuration [-z serveur] [-p port] [-I adresse-IP]
       [-t délai] [-s hôte] --tls-connect cert --tls-ca-file fichier-CA
       [--tls-crl-file fichier-CRL] [--tls-server-cert-issuer émetteur-du-certificat]
       [--tls-server-cert-subject sujet-du-certificat] --tls-cert-file fichier-de-certificat
       --tls-key-file fichier-de-clé [--tls-cipher13 chaîne-de-chiffrement] [--tls-cipher
       chaîne-de-chiffrement] -k clé -o valeur
       zabbix_sender [-v] -c fichier-de-configuration [-z serveur] [-p port] [-I adresse-IP]
       [-t délai] [-s hôte] --tls-connect cert --tls-ca-file fichier-CA [--tls-crl-file
       fichier-CRL] [--tls-server-cert-issuer émetteur-du-certificat]
       [--tls-server-cert-subject sujet-du-certificat] --tls-cert-file fichier-de-certificat
       --tls-key-file fichier-de-clé [--tls-cipher13 chaîne-de-chiffrement] [--tls-cipher
       chaîne-de-chiffrement] [-T] [-N] [-r] -i fichier-d'entrée
       zabbix_sender [-v] -z serveur [-p port] [-I adresse-IP] [-t délai] -s
       hôte --tls-connect psk --tls-psk-identity identité-PSK --tls-psk-file
       fichier-PSK [--tls-cipher13 chaîne-de-chiffrement] [--tls-cipher chaîne-de-chiffrement] -k
       clé -o valeur
       zabbix_sender [-v] -z serveur [-p port] [-I adresse-IP] [-t délai] [-s
       hôte] --tls-connect psk --tls-psk-identity identité-PSK --tls-psk-file
       fichier-PSK [--tls-cipher13 chaîne-de-chiffrement] [--tls-cipher chaîne-de-chiffrement]
       [-T] [-N] [-r] -i fichier-d'entrée
       zabbix_sender [-v] -c fichier-de-configuration [-z serveur] [-p port] [-I adresse-IP]
       [-t délai] [-s hôte] --tls-connect psk --tls-psk-identity identité-PSK
       --tls-psk-file fichier-PSK [--tls-cipher13 chaîne-de-chiffrement] [--tls-cipher
       chaîne-de-chiffrement] -k clé -o valeur
       zabbix_sender [-v] -c fichier-de-configuration [-z serveur] [-p port] [-I adresse-IP]
       [-t délai] [-s hôte] --tls-connect psk --tls-psk-identity identité-PSK
       --tls-psk-file fichier-PSK [--tls-cipher13 chaîne-de-chiffrement] [--tls-cipher
       chaîne-de-chiffrement] [-T] [-N] [-r] -i fichier-d'entrée
       zabbix_sender -h
       zabbix_sender -V

DESCRIPTION
       zabbix_sender est un utilitaire en ligne de commande permettant d'envoyer des données
       de supervision au serveur Zabbix ou au proxy. Sur le serveur Zabbix, un élément de type
       Zabbix trapper doit être créé avec la clé correspondante. Notez que les valeurs
       entrantes ne seront acceptées que depuis les hôtes indiqués dans le champ Hôtes autorisés
       de cet élément.

OPTIONS
       -c, --config fichier-de-configuration
              Utiliser fichier-de-configuration. Zabbix sender lit les détails du serveur dans
              le fichier de configuration de agentd. L'agent n'a pas besoin d'être en cours
              d'exécution pour que zabbix_sender envoie des données. Par défaut, Zabbix sender
              ne lit aucun fichier de configuration. Seuls les paramètres Hostname, ServerActive,
              SourceIP, TLSConnect, TLSCAFile, TLSCRLFile, TLSServerCertIssuer,
              TLSServerCertSubject, TLSCertFile, TLSKeyFile, TLSPSKIdentity et TLSPSKFile sont
              pris en charge. Le Hostname défini via le paramètre HostnameItem ne sera pas pris
              en compte ; dans ce cas, le nom d'hôte doit être indiqué via la ligne de commande
              (voir l'option -s). Toutes les adresses définies dans le paramètre de configuration
              ServerActive de l'agent sont utilisées pour envoyer les données. Si l'envoi d'un
              lot de données échoue vers une adresse, les lots suivants ne sont pas envoyés à
              cette adresse.

       -z, --zabbix-server serveur
              Nom d'hôte ou adresse IP du serveur Zabbix. Si un hôte est supervisé par un proxy,
              le nom d'hôte ou l'adresse IP du proxy doit être utilisé à la place. Utilisé avec
              --config, ce paramètre remplace les entrées du paramètre ServerActive indiquées
              dans le fichier de configuration de agentd.

       -p, --port port
              Indiquer le numéro de port du trapper Zabbix server exécuté sur le serveur. La
              valeur par défaut est 10051. Utilisé avec --config, ce paramètre remplace les
              entrées de port du paramètre ServerActive indiquées dans le fichier de
              configuration de agentd.

       -I, --source-address adresse-IP
              Indiquer l'adresse IP source. Utilisé avec --config, ce paramètre remplace le
              paramètre SourceIP indiqué dans le fichier de configuration de agentd.

       -t, --timeout secondes
              Indiquer le délai d'expiration. Plage valide : 1 à 300 secondes (valeur par
              défaut : 60).

       -s, --host hôte
              Indiquer le nom de l'hôte auquel appartient l'élément (tel qu'il est enregistré
              dans l'interface Zabbix). L'adresse IP et le nom DNS de l'hôte ne fonctionneront
              pas. Utilisé avec --config, ce paramètre remplace le paramètre Hostname indiqué
              dans le fichier de configuration de agentd.

       -k, --key clé
              Indiquer la clé de l'élément auquel envoyer la valeur.

       -o, --value valeur
              Indiquer la valeur de l'élément.

       -i, --input-file fichier-d'entrée
              Charger les valeurs depuis un fichier d'entrée. Indiquer - comme <fichier-d'entrée>
              pour lire les valeurs depuis l'entrée standard. Chaque ligne du fichier contient,
              séparés par des espaces, les éléments suivants : <nom-d'hôte> <clé> <valeur>.
              Chaque valeur doit être indiquée sur sa propre ligne. Chaque ligne doit contenir
              3 entrées séparées par des espaces : <nom-d'hôte> <clé> <valeur>, où « nom-d'hôte »
              est le nom de l'hôte supervisé tel qu'il est enregistré dans l'interface Zabbix,
              « clé » est la clé de l'élément cible et « valeur » est la valeur à envoyer.
              Indiquer - comme <nom-d'hôte> pour utiliser le nom d'hôte du fichier de
              configuration de l'agent ou de l'argument --host.

              Exemple de ligne d'un fichier d'entrée :

               "Linux DB3" db.connections 43

              Le type de valeur doit être correctement défini dans la configuration de l'élément
              de l'interface Zabbix. Zabbix sender envoie jusqu'à 250 valeurs par connexion. Le
              contenu du fichier d'entrée doit être encodé en UTF-8. Toutes les valeurs du
              fichier d'entrée sont envoyées séquentiellement, de haut en bas. Les entrées
              doivent être formatées selon les règles suivantes :

                     • Les entrées entre guillemets et sans guillemets sont prises en charge.

                     • Le guillemet double est le caractère utilisé pour encadrer les valeurs.

                     • Les entrées contenant des espaces doivent être placées entre guillemets.

                     • Les guillemets doubles et les barres obliques inverses à l'intérieur d'une
                       entrée entre guillemets doivent être échappés avec une barre oblique inverse.

                     • L'échappement n'est pas pris en charge dans les entrées sans guillemets.

                     • Les séquences d'échappement de saut de ligne (\n) sont prises en charge
                       dans les chaînes entre guillemets.

                     • Les séquences d'échappement de saut de ligne sont supprimées à la fin
                       d'une entrée.

       -T, --with-timestamps
              Cette option ne peut être utilisée qu'avec l'option --input-file.

              Chaque ligne du fichier d'entrée doit contenir 4 entrées séparées par des espaces :
              <nom-d'hôte> <clé> <horodatage> <valeur>. L'horodatage doit être indiqué au format
              d'horodatage Unix. Si l'élément cible possède des déclencheurs qui le référencent,
              tous les horodatages doivent être dans un ordre croissant ; sinon, le calcul des
              événements ne sera pas correct.

              Exemple de ligne d'un fichier d'entrée :

               "Linux DB3" db.connections 1429533600 43

              Pour plus de détails, consultez l'option --input-file.

              Si une valeur horodatée est envoyée pour un hôte qui se trouve dans une période de
              maintenance de type « aucune donnée », cette valeur sera ignorée ; toutefois, il
              est possible d'envoyer une valeur horodatée pendant une période de maintenance
              expirée, et celle-ci sera acceptée.

       -N, --with-ns
              Cette option ne peut être utilisée qu'avec l'option --with-timestamps.

              Chaque ligne du fichier d'entrée doit contenir 5 entrées séparées par des espaces :
              <nom-d'hôte> <clé> <horodatage> <ns> <valeur>.

              Exemple de ligne d'un fichier d'entrée :

               "Linux DB3" db.connections 1429533600 7402561 43

              Pour plus de détails, consultez l'option --input-file.

       -r, --real-time
              Envoyer les valeurs une par une dès leur réception. Cette option peut être utilisée
              lors de la lecture depuis l'entrée standard.

       --tls-connect valeur
              Méthode de connexion au serveur ou au proxy. Valeurs :

                   unencrypted
                               se connecter sans chiffrement (valeur par défaut)

                   psk         se connecter avec TLS et une clé prépartagée

                   cert        se connecter avec TLS et un certificat

       --tls-ca-file fichier-CA
              Chemin complet d'un fichier contenant les certificats de l'autorité de
              certification racine nécessaires à la vérification du certificat du pair.

       --tls-crl-file fichier-CRL
              Chemin complet d'un fichier contenant les certificats révoqués.

       --tls-server-cert-issuer émetteur-du-certificat
              Émetteur de certificat du serveur autorisé.

       --tls-server-cert-subject sujet-du-certificat
              Sujet de certificat du serveur autorisé.

       --tls-cert-file fichier-de-certificat
              Chemin complet d'un fichier contenant le certificat ou la chaîne de certificats.

       --tls-key-file fichier-de-clé
              Chemin complet d'un fichier contenant la clé privée.

       --tls-psk-identity identité-PSK
              Chaîne d'identité PSK. Elle doit correspondre à l'identité PSK définie pour l'hôte
              dans l'interface Zabbix.

       --tls-psk-file fichier-PSK
              Chemin complet d'un fichier contenant la clé prépartagée. La clé de ce fichier
              doit correspondre à la valeur PSK définie pour l'hôte dans l'interface Zabbix.

       --tls-cipher13 chaîne-de-chiffrement
              Chaîne de chiffrement pour OpenSSL 1.1.1 ou version ultérieure avec TLS 1.3.
              Remplace les critères de sélection de la suite de chiffrement par défaut. Cette
              option n'est pas disponible si la version d'OpenSSL est antérieure à 1.1.1.

       --tls-cipher chaîne-de-chiffrement
              Chaîne de priorité GnuTLS (pour TLS 1.2 et versions ultérieures) ou chaîne de
              chiffrement OpenSSL (uniquement pour TLS 1.2). Remplace les critères de sélection
              de la suite de chiffrement par défaut.

       -v, --verbose
              Mode détaillé ; -vv fournit davantage de détails.

       -h, --help
              Afficher cette aide et quitter.

       -V, --version
              Afficher les informations de version et quitter.

ÉTAT DE SORTIE
       L'état de sortie est 0 si les valeurs ont été envoyées et ont toutes été traitées avec
       succès par le serveur. Si les données ont été envoyées, mais que le traitement d'au moins
       une valeur a échoué, l'état de sortie est 2. Si l'envoi des données a échoué, l'état de
       sortie est 1.

EXEMPLES
       zabbix_sender -c  /etc/zabbix/zabbix_agentd.conf  -k  zabbix.trapper -o
       342.45
              Envoyer 342.45 comme valeur de l'élément zabbix.trapper de l'hôte supervisé.
              Utiliser l'hôte supervisé et le serveur Zabbix définis dans le fichier de
              configuration de l'agent.

       zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host"  -k
       zabbix.trapper -o 342.45
              Envoyer 342.45 comme valeur de l'élément zabbix.trapper de l'hôte Monitored Host
              en utilisant le serveur Zabbix défini dans le fichier de configuration de l'agent.

       zabbix_sender -z 192.168.1.113 -i data_values.txt
              Envoyer les valeurs du fichier data_values.txt au serveur Zabbix dont l'adresse IP
              est 192.168.1.113. Les noms d'hôtes et les clés sont définis dans le fichier.

       echo "- hw.serial.number  1287872261  SQ4321ASDF"  |  zabbix_sender  -c
       /usr/local/etc/zabbix_agentd.conf -T -i -
              Envoyer une valeur horodatée depuis la ligne de commande au serveur Zabbix indiqué
              dans le fichier de configuration de l'agent. Le tiret dans les données d'entrée
              indique que le nom d'hôte doit également être utilisé depuis ce même fichier de
              configuration.

       echo '"Zabbix server" zabbix.trapper ""' | zabbix_sender -z 192.168.1.113
       -p 10000 -i -
              Envoyer une valeur vide d'un élément au serveur Zabbix dont l'adresse IP est
              192.168.1.113, sur le port 10000, depuis la ligne de commande. Les valeurs vides
              doivent être indiquées par des guillemets doubles vides.

       zabbix_sender -z 192.168.1.113 -s "Monitored Host" -k zabbix.trapper -o
       342.45  --tls-connect  cert  --tls-ca-file  /home/zabbix/zabbix_ca_file
       --tls-cert-file      /home/zabbix/zabbix_agentd.crt      --tls-key-file
       /home/zabbix/zabbix_agentd.key
              Envoyer 342.45 comme valeur de l'élément zabbix.trapper de l'hôte Monitored Host
              au serveur dont l'adresse IP est 192.168.1.113, en utilisant TLS avec un certificat.

       zabbix_sender -z 192.168.1.113 -s "Monitored Host" -k zabbix.trapper -o
       342.45  --tls-connect  psk  --tls-psk-identity  "PSK  ID Zabbix agentd"
       --tls-psk-file /home/zabbix/zabbix_agentd.psk
              Envoyer 342.45 comme valeur de l'élément zabbix.trapper de l'hôte Monitored Host
              au serveur dont l'adresse IP est 192.168.1.113, en utilisant TLS avec une clé
              prépartagée (PSK).

VOIR AUSSI
       Documentation

       zabbix_agentd(8),  zabbix_get(1),  zabbix_proxy(8),   zabbix_server(8),
       zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8)

Zabbix                            2022-01-06                  ZABBIX_SENDER(1)