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-certificat --tls-key-file fichier-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-certificat
--tls-key-file fichier-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-certificat
--tls-key-file fichier-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-certificat
--tls-key-file fichier-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
depuis le fichier de configuration de agentd. 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 récupéré ; 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 agent sont utilisées pour l'envoi des données. Si
l'envoi de données par lots é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 sur lequel le trapper du serveur Zabbix s'exécute.
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 : <hostname> <key> <value>. Chaque
valeur doit être indiquée sur sa propre ligne. Chaque ligne doit contenir
3 entrées séparées par des espaces : <hostname> <key> <value>, où « hostname »
est le nom de l'hôte supervisé tel qu'il est enregistré dans l'interface Zabbix,
« key » est la clé de l'élément cible et « value » est la valeur à envoyer.
Indiquer - comme <hostname> pour utiliser le nom d'hôte du fichier de
configuration de 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 dans l'ordre séquentiel, 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 de citation.
• Les entrées contenant des espaces doivent être placées entre guillemets.
• Les caractères guillemet double et barre oblique inverse à 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 :
<hostname> <key> <timestamp> <value>. 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 elle 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 :
<hostname> <key> <timestamp> <ns> <value>.
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 des autorités de
certification (CA) de niveau supérieur pour la vérification du certificat de
l'homologue.
--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-certificat
Chemin complet d'un fichier contenant le certificat ou la chaîne de certificats.
--tls-key-file fichier-clé
Chemin complet d'un fichier contenant la clé privée.
--tls-psk-identity identité-PSK
Chaîne d'identité PSK.
--tls-psk-file fichier-PSK
Chemin complet d'un fichier contenant la clé prépartagée.
--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é ; utiliser -vv pour obtenir plus 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 si elles 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 mysql.queries -o
342.45
Envoyer 342.45 comme valeur de l'élément mysql.queries de l'hôte supervisé.
Utiliser l'hôte supervisé et le serveur Zabbix définis dans le fichier de
configuration de agent.
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k
mysql.queries -o 342.45
Envoyer 342.45 comme valeur de l'élément mysql.queries de l'hôte Monitored Host
en utilisant le serveur Zabbix défini dans le fichier de configuration de 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 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" trapper.item ""' | 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 mysql.queries -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 mysql.queries 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 mysql.queries -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 mysql.queries 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)