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-cert] [--tls-server-cert-subject
sujet-cert] --tls-cert-file fichier-cert --tls-key-file fichier-clé
[--tls-cipher13 chaîne-cipher] [--tls-cipher chaîne-cipher] -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-cert]
[--tls-server-cert-subject sujet-cert] --tls-cert-file fichier-cert
--tls-key-file fichier-clé [--tls-cipher13 chaîne-cipher] [--tls-cipher
chaîne-cipher] [-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-cert] [--tls-server-cert-subject sujet-cert] --tls-cert-file
fichier-cert --tls-key-file fichier-clé [--tls-cipher13 chaîne-cipher]
[--tls-cipher chaîne-cipher] -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-cert] [--tls-server-cert-subject sujet-cert] --tls-cert-file
fichier-cert --tls-key-file fichier-clé [--tls-cipher13 chaîne-cipher]
[--tls-cipher chaîne-cipher] [-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-cert] [--tls-server-cert-subject sujet-cert] --tls-cert-file
fichier-cert --tls-key-file fichier-clé [--tls-cipher13 chaîne-cipher]
[--tls-cipher chaîne-cipher] -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-cert] [--tls-server-cert-subject sujet-cert] --tls-cert-file
fichier-cert --tls-key-file fichier-clé [--tls-cipher13 chaîne-cipher]
[--tls-cipher chaîne-cipher] [-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-cipher] [--tls-cipher chaîne-cipher] -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-cipher] [--tls-cipher chaîne-cipher]
[-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-cipher]
[--tls-cipher chaîne-cipher] -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-cipher]
[--tls-cipher chaîne-cipher] [-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 spécifiés dans le champ Hôtes autorisés de cet élément.
OPTIONS
-c, --config fichier de configuration
Utiliser le fichier de configuration. Zabbix sender lit les détails
du serveur à partir du 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 pris en compte ; 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 ServerActive de agent
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 serveur
Nom d'hôte ou adresse IP du serveur Zabbix. Si un hôte est
supervisé par un proxy, il faut utiliser à la place le nom d'hôte
ou l'adresse IP du proxy. Lorsqu'il est utilisé avec --config,
remplace les entrées du paramètre ServerActive spécifiées dans le
fichier de configuration de 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'il est
utilisé avec --config, remplace les entrées de port du paramètre
ServerActive spécifiées dans le fichier de configuration de agentd.
-I, --source-address adresse IP
Spécifier l'adresse IP source. Lorsqu'il est utilisé avec --config,
remplace le paramètre SourceIP spécifié dans le fichier de
configuration de agentd.
-t, --timeout secondes
Spécifier le délai d'attente. Plage valide: 1-300 secondes
(par défaut: 60)
-s, --host hôte
Spécifier le nom d'hôte auquel l'élément appartient (tel
qu'enregistré dans l'interface Zabbix). L'adresse IP de l'hôte et
le nom DNS ne fonctionneront pas. Lorsqu'il est utilisé avec
--config, remplace le paramètre Hostname spécifié dans le fichier
de configuration de agentd.
-k, --key clé
Spécifier la clé de l'élément à laquelle envoyer la valeur.
-o, --value valeur
Spécifier la valeur de l'élément.
-i, --input-file fichier d'entrée
Charger les valeurs depuis un fichier d'entrée. Spécifiez - 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:
<nom d'hôte> <clé> <valeur>. Chaque valeur doit être spécifié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'enregistré dans l'interface Zabbix,
"clé" est la clé de l'élément cible et "valeur" est la valeur à
envoyer. Spécifiez - comme <nom d'hôte> pour utiliser le nom
d'hôte provenant 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 dans 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équentiel de haut
en bas. Les entrées doivent être formatées selon les règles
suivantes:
• Les entrées entre guillemets et non entre guillemets
sont prises en charge.
• Le caractère de citation est le guillemet double.
• Les entrées contenant des espaces doivent être entre
guillemets.
• Les caractères guillemet double et antislash à l'intérieur
d'une entrée entre guillemets doivent être échappés avec
un antislash.
• L'échappement n'est pas pris en charge dans les entrées
non entre 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 spécifié au format d'horodatage Unix. Si
l'élément cible a des déclencheurs qui y font référence, 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, veuillez consulter l'option --input-file.
Si une valeur horodatée est envoyée pour un hôte en maintenance de
type "aucune donnée", cette valeur sera ignorée; toutefois, il est
possible d'envoyer une valeur horodatée pour 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: <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, veuillez consulter l'option --input-file.
-r, --real-time
Envoyer les valeurs une par une dès qu'elles sont reçues. Cela peut
être utilisé lors de la lecture depuis l'entrée standard.
--tls-connect valeur
Mode de connexion au serveur ou au proxy. Valeurs:
unencrypted
connexion sans chiffrement (par défaut)
psk connexion à l'aide de TLS et d'une clé
pré-partagée
cert connexion à l'aide de TLS et d'un certificat
--tls-ca-file fichier CA
Chemin complet d'un fichier contenant les certificats des AC
racines pour 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-cert
Émetteur de certificat serveur autorisé.
--tls-server-cert-subject sujet-cert
Sujet de certificat serveur autorisé.
--tls-cert-file fichier-cert
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-cipher
Chaîne de suites cryptographiques pour OpenSSL 1.1.1 ou version
ultérieure pour TLS 1.3. Remplace les critères de sélection de la
suite cryptographique par défaut. Cette option n'est pas disponible
si la version d'OpenSSL est inférieure à 1.1.1.
--tls-cipher chaîne-cipher
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 cryptographique par défaut.
-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.
ÉTAT DE SORTIE
L'état de sortie est 0 si les valeurs ont été envoyées et que toutes ont
é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 des valeurs 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é. Utilise 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
avec l'adresse 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 agent. Le tiret
dans les données d'entrée indique que le nom d'hôte doit également
être utilisé depuis le 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 de l'élément mysql.queries dans l'hôte
Monitored Host au serveur avec l'adresse IP 192.168.1.113 en
utilisant TLS avec 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 dans l'hôte
Monitored Host au serveur avec l'adresse 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)