Documentation
Table of Contents
zabbix_sender
Section : Commandes utilisateur (1)
Mise à jour : 2021-06-01
Index Retour au sommaire principal
NOM
zabbix_sender - Utilitaire Zabbix sender
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] -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-identity --tls-psk-file PSK-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 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 -h
zabbix_sender -V
DESCRIPTION
zabbix_sender est un utilitaire de ligne de commande pour envoyer des données de surveillance au serveur ou au proxy Zabbix. Sur le serveur Zabbix, un élément de type trappeur Zabbix doit être créé avec la clé correspondante. Notez que les valeurs entrantes ne seront acceptées qu'à partir des hôtes spécifiés dans le champ Hôtes autorisés pour cet élément.
OPTIONS
-c, --config config-file
Utilisez config-file. Le Zabbix sender lit les détails du serveur à partir du fichier de configuration de l'agent. Par défaut, le 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. Toutes les adresses définies dans le paramètre de configuration de l'agent ServerActive** sont utilisées pour envoyer des données. Si l'envoi des données de lot échoue à 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 surveillé par un proxy, le nom d'hôte ou l'adresse IP du proxy doit être utilisé à la place. Lorsqu'il est utilisé avec --config, remplace les entrées du paramètre ServerActive spécifié dans le fichier de configuration de l'agent.
-p, --port port
Spécifier le numéro de port du trappeur de 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é dans le fichier de configuration de l'agent.
-I, --source-address IP-address
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 l'agent.
-t, --timeout seconds
Spécifier le délai d'attente. Plage valide : 1-300 secondes (par défaut : 60)
-s, --host host
Spécifier le nom d'hôte auquel appartient l'élément (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 l'agent.
-k, --key key
Spécifier la clé de l'élément à laquelle envoyer la valeur.
-o, --value value
Spécifier la valeur de l'élément.
-i, --input-file input-file
Charger les valeurs du fichier d'entrée. Spécifiez - comme <input-file> pour lire les valeurs à partir de l'entrée standard. Chaque ligne de fichier contient des espaces délimités : <hostname> <key> <value>. Chaque valeur doit être spécifiée sur sa propre ligne. Chaque ligne doit contenir 3 entrées délimitées par des espaces : <hostname> <key> <value>, où "hostname" est le nom de l'hôte surveillé tel qu'il est enregistré dans l'interface Zabbix, "key" est la clé de l'élément cible et "value" - la valeur à envoyer. Spécifier - comme <hostname> pour utiliser le nom d'hôte du fichier de configuration de l'agent ou de l'argument --host.
Un 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. Le Zabbix sender enverra jusqu'à 250 valeurs en une seule connexion. Taille limite pour l'envoi de valeurs à partir d'un fichier d'entrée dépend de la taille décrite dans le protocole de communication Zabbix. Le contenu du fichier d'entrée doit être au codage 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 sans guillemets sont prises en charge.
•
Le guillemet double est le caractère guillemet.
•
Les entrées avec des espaces doivent être entre guillemets.
•
Les guillemets doubles et les barres obliques inverses à l'intérieur d'une entrée entre guillemets doivent être protégés par 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 coupées à partir 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 délimité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 croissant, sinon le calcul de l'événement ne sera pas correct.
Un exemple de ligne du fichier d'entrée :
"Linux DB3" db.connections 1429533600 43
Pour plus de détails, consulter l'option --input-file.
Si une valeur horodatée est envoyée pour un hôte qui est dans un type de maintenance "sans donnée", cette valeur sera supprimée ; cependant, 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 délimitées par des espaces : <hostname> <key> <timestamp> <ns> <value>.
Un exemple de ligne du 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 à partir d'une entrée standard.
--tls-connect value
Comment se connecter au serveur ou au proxy. Valeurs:
unencrypted
se connecter sans cryptage (par défaut)
psk
se connecter en utilisant TLS et une clé pré-partagée
cert
se connecter à l'aide de TLS et d'un certificat
--tls-ca-file CA-file
Chemin d'accès complet d'un fichier contenant les certificats des autorités de certification de niveau supérieur pour la vérification des certificats homologues.
--tls-crl-file CRL-file
Chemin d'accès complet d'un fichier contenant des certificats révoqués.
--tls-server-cert-issuer cert-issuer
Émetteur de certificat de serveur autorisé.
--tls-server-cert-subject cert-subject
Sujet du certificat de serveur autorisé.
--tls-cert-file cert-file
Chemin d'accès complet d'un fichier contenant le certificat ou la chaîne de certificats.
--tls-key-file key-file
Chemin d'accès complet d'un fichier contenant la clé privée.
--tls-psk-identity PSK-identity
Chaîne d'identité PSK.
--tls-psk-file PSK-file
Chemin d'accès complet d'un fichier contenant la clé pré-partagée.
--tls-cipher13 cipher-string
Chaîne de chiffrement pour OpenSSL 1.1.1 ou plus récent pour TLS 1.3. Remplacer les critères de sélection de suite de chiffrement par défaut. 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 versions ultérieures) ou chaîne de chiffrement OpenSSL (uniquement pour TLS 1.2). Remplacer les critères de sélection de suite de chiffrement 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.
ETAT DE SORTIE
L'état de sortie est 0 si les valeurs ont été envoyées et qu'elles ont toutes été traitées avec succès par le serveur. Si des 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 pour l'élément mysql.queries de l'hôte surveillé. Utiliser l'hôte surveillé 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 mysql.queries -o 342.45
Envoyer 342.45 comme valeur pour l'élément mysql.queries de l'hôte Monitored Host 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ée 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é à partir du même fichier de configuration.
echo '"Zabbix server" trapper.item ""' | zabbix_sender -z 192.168.1.113 -p 10000 -i -
Envoyer la valeur vide d'un élément au serveur Zabbix avec l'adresse IP 192.168.1.113 sur le port 10000 à partir de 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
Envoyez 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 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
Envoyez 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 la clé pré-partagée (PSK).
VOIR EGALEMENT
Documentation https://www.zabbix.com/manuals
zabbix_agentd(8), zabbix_get(1), zabbix_proxy(8), zabbix_server(8), zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8)
AUTEUR
Alexei Vladishev <[email protected]>
Index
Ce document a été créé le : 08:42:39 GMT, June 11, 2021