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)