Sommaire
zabbix_sender
ZABBIX_SENDER(1) Manuel général des commandes ZABBIX_SENDER(1)
NOM
zabbix_sender - Utilitaire d'envoi Zabbix
SYNOPSIS
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] -s
host -k key -o value
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] [-s
host] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] -s
host --tls-connect cert --tls-ca-file CA-file [--tls-crl-file CRL-file]
[--tls-server-cert-issuer cert-issuer] [--tls-server-cert-subject
cert-subject] --tls-cert-file cert-file --tls-key-file key-file
[--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k key -o
value
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] [-s
host] --tls-connect cert --tls-ca-file CA-file [--tls-crl-file
CRL-file] [--tls-server-cert-issuer cert-issuer]
[--tls-server-cert-subject cert-subject] --tls-cert-file cert-file
--tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file
[--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer]
[--tls-server-cert-subject cert-subject] --tls-cert-file cert-file
--tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file
[--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer]
[--tls-server-cert-subject cert-subject] --tls-cert-file cert-file
--tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file
[--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer]
[--tls-server-cert-subject cert-subject] --tls-cert-file cert-file
--tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] --tls-connect cert --tls-ca-file CA-file
[--tls-crl-file CRL-file] [--tls-server-cert-issuer cert-issuer]
[--tls-server-cert-subject cert-subject] --tls-cert-file cert-file
--tls-key-file key-file [--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] [-T] [-N] [-r] -i input-file
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] -s
host --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file
PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k
key -o value
zabbix_sender [-v] -z server [-p port] [-I IP-address] [-t timeout] [-s
host] --tls-connect psk --tls-psk-identity PSK-identity --tls-psk-file
PSK-file [--tls-cipher13 cipher-string] [--tls-cipher cipher-string]
[-T] [-N] [-r] -i input-file
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] --tls-connect psk --tls-psk-identity PSK-iden‐
tity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-ci‐
pher cipher-string] -k key -o value
zabbix_sender [-v] -c config-file [-z server] [-p port] [-I IP-address]
[-t timeout] [-s host] --tls-connect psk --tls-psk-identity PSK-iden‐
tity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-ci‐
pher cipher-string] [-T] [-N] [-r] -i input-file
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 ou proxy Zabbix. 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 spécifiés dans le champ Allowed hosts
pour cet élément.
OPTIONS
-c, --config config-file
Utiliser config-file. Zabbix sender lit les détails du serveur à partir du
fichier de configuration agentd. Par défaut, Zabbix sender ne
lit aucun fichier de configuration. Seuls les paramètres Hostname, Server‐
Active, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile,
TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKey‐
File, 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 spécifié via la ligne de commande (voir
l'option -s). Toutes les adresses définies dans le paramètre de configuration agent ServerActive
sont utilisées pour l'envoi des données. Si l'envoi
de données par lot échoue vers une adresse, les lots suivants ne sont
pas envoyés à cette adresse.
-z, --zabbix-server server
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.
Lorsqu'elle est utilisée avec --config, cette option remplace les entrées du
paramètre ServerActive spécifié dans le fichier de configuration agentd.
-p, --port port
Spécifier le numéro de port du trapper du serveur Zabbix exécuté sur le
serveur. La valeur par défaut est 10051. Lorsqu'elle est utilisée avec --config,
cette option remplace les entrées de port du paramètre ServerActive spécifié
dans le fichier de configuration agentd.
-I, --source-address IP-address
Spécifier l'adresse IP source. Lorsqu'elle est utilisée avec --config,
cette option remplace le paramètre SourceIP spécifié dans le fichier de configuration
agentd.
-t, --timeout seconds
Spécifier le délai d'expiration. Plage valide : 1-300 secondes (par défaut : 60)
-s, --host host
Spécifier le nom de l'hôte auquel appartient l'élément (tel qu'enregistré dans l'interface
Zabbix). L'adresse IP et le nom DNS de l'hôte ne fonctionneront pas. Lorsqu'elle est
utilisée avec --config, cette option remplace le paramètre Hostname spéci‐
fié dans le fichier de configuration agentd.
-k, --key key
Spécifier la clé de l'élément auquel envoyer la valeur.
-o, --value value
Spécifier la valeur de l'élément.
-i, --input-file input-file
Charger les valeurs depuis le fichier d'entrée. Spécifiez - comme <input-file> pour
lire les valeurs depuis l'entrée standard. Chaque ligne du fichier contient des champs sépa‐
rés par des espaces : <hostname> <key> <value>. Chaque valeur doit être
spécifié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'enregistré dans l'interface Zabbix,
"key" est la clé de l'élément cible et "value" la valeur à envoyer. Spéci‐
fiez - comme <hostname> pour utiliser le nom d'hôte du fichier de configuration de l'agent
ou de l'argument --host.
Exemple de ligne dans 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 enverra jusqu'à 250 valeurs dans
une seule 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 un ordre séquen‐
tiel de haut en bas. Les entrées doivent être formatées selon les règles sui‐
vantes :
• 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 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 de 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 spécifié au format d'horodatage Unix. Si l'élément cible a des déclencheurs
qui le référencent, tous les horodatages doivent être dans un ordre crois‐
sant, sinon le calcul des événements ne sera pas correct.
Exemple de ligne dans un fichier d'entrée :
"Linux DB3" db.connections 1429533600 43
Pour plus de détails, veuillez consulter l'option --input-file.
Si une valeur horodatée est envoyée pour un hôte qui est dans un type de maintenance « no data »
alors cette valeur sera ignorée ; cependant, il est
possible d'envoyer une valeur horodatée pour une période de mainte‐
nance 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 dans un fichier d'entrée :
"Linux DB3" db.connections 1429533600 7402561 43
Pour plus de détails, veuillez consulter l'option --input-file.
-r, --real-time
Envoyer les valeurs une par une dès leur réception. Cela peut
être utilisé lors de la lecture depuis l'entrée standard.
--tls-connect value
Comment se connecter au serveur ou proxy. Valeurs :
unencrypted
se connecter sans chiffrement (par défaut)
psk se connecter en utilisant TLS et une clé pré-partagée
cert se connecter en utilisant TLS et un certificat
--tls-ca-file CA-file
Chemin complet d'un fichier contenant les certificats de la ou des CA de niveau supérieur
pour la vérification du certificat du pair.
--tls-crl-file CRL-file
Chemin complet d'un fichier contenant les certificats révoqués.
--tls-server-cert-issuer cert-issuer
Émetteur de certificat du serveur autorisé.
--tls-server-cert-subject cert-subject
Sujet de certificat du serveur autorisé.
--tls-cert-file cert-file
Chemin complet d'un fichier contenant le certificat ou la chaîne de certifi‐
cats.
--tls-key-file key-file
Chemin complet d'un fichier contenant la clé privée.
--tls-psk-identity PSK-identity
Chaîne PSK-identity.
--tls-psk-file PSK-file
Chemin complet d'un fichier contenant la clé pré-partagée.
--tls-cipher13 cipher-string
Chaîne de chiffrement pour OpenSSL 1.1.1 ou version plus récente pour TLS 1.3. Remplace
les critères de sélection par défaut de la suite de chiffrement. Cette option n'est pas
disponible si la version d'OpenSSL est inférieure à 1.1.1.
--tls-cipher cipher-string
Chaîne de priorité GnuTLS (pour TLS 1.2 et supérieur) ou chaîne de chiffrement OpenSSL
(uniquement pour TLS 1.2). Remplace les critères de sélection par défaut de la suite de chif‐
frement.
-v, --verbose
Mode verbeux, -vv pour plus de détails.
-h, --help
Afficher cette aide et quitter.
-V, --version
Afficher les informations de version et quitter.
STATUT DE SORTIE
Le statut de sortie est 0 si les valeurs ont été envoyées et si elles ont toutes été trai‐
tées avec succès par le serveur. Si les données ont été envoyées, mais que le traitement d'au
moins une des valeurs a échoué, le statut de sortie est 2. Si l'envoi des données
a échoué, le statut de sortie est 1.
EXEMPLES
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k mysql.queries -o
342.45
Envoyer 342.45 comme valeur pour 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 con‐
figuration de l'agent.
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k
mysql.queries -o 342.45
Envoyer 342.45 comme valeur pour l'élément mysql.queries 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 avec l'IP
192.168.1.113. Les noms d'hôte 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,
spécifié 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" trapper.item ""' | zabbix_sender -z 192.168.1.113
-p 10000 -i -
Envoyer une valeur vide d'un élément au serveur Zabbix avec l'adresse IP
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 pour l'élément mysql.queries de l'hôte Monitored
Host au serveur avec l'IP 192.168.1.113 en utilisant TLS avec certifi‐
cat.
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 pour l'élément mysql.queries de l'hôte Monitored
Host au serveur avec l'IP 192.168.1.113 en utilisant TLS avec 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)