zabbix_sender [-v] -z serveur [-p port] [-I adresse-IP] [-t délai d'expiration] -s hôte -k clé -o valeur
zabbix_sender [-v] -z serveur [-p port] [-I adresse-IP] [-t délai d'expiration] [-s hôte] [-T] [-N] [-r] [-g] -i fichier-d'entrée
zabbix_sender [-v] -c fichier-de-configuration [-z serveur] [-p port] [-I adresse-IP] [-t délai d'expiration] [-s hôte] -k clé -o valeur
zabbix_sender [-v] -c fichier-de-configuration [-z serveur] [-p port] [-I adresse-IP] [-t délai d'expiration] [-s hôte] [-T] [-N] [-r] [-g] -i fichier-d'entrée
zabbix_sender [-v] -z serveur [-p port] [-I adresse-IP] [-t délai d'expiration] -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 d'expiration] [-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] [-g] -i fichier-d'entrée
zabbix_sender [-v] -c fichier-de-configuration [-z serveur] [-p port] [-I adresse-IP] [-t délai d'expiration] [-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 d'expiration] [-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] [-g] -i fichier-d'entrée
zabbix_sender [-v] -z serveur [-p port] [-I adresse-IP] [-t délai d'expiration] -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 d'expiration] [-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] [-g] -i fichier-d'entrée
zabbix_sender [-v] -c fichier-de-configuration [-z serveur] [-p port] [-I adresse-IP] [-t délai d'expiration] [-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 d'expiration] [-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] [-g] -i fichier-d'entrée
zabbix_sender -h
zabbix_sender -V [ ]{#lbAD}

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. [ ]{#lbAE}

OPTIONS

-c, --config fichier-config
Utiliser fichier-config. 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, ServerActive, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile, TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKeyFile, TLSPSKIdentity et TLSPSKFile sont pris en charge.
Le nom d'hôte défini via le paramètre HostnameItem ne sera pas repris ; 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 l'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, 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ées 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ées dans le fichier de configuration agentd.

-I, --source-address adresse-IP
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 secondes
Spécifier le délai d'expiration. 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 le frontend Zabbix). L'adresse IP de l'hôte et le nom DNS ne fonctionneront pas. Lorsqu'elle est utilisée avec --config, cette option remplace le paramètre Hostname spécifié dans le fichier de configuration agentd.

-k, --key clé
Spécifier la clé de l'élément auquel envoyer la valeur.

-o, --value valeur
Spécifier la valeur de l'élément.

-i, --input-file fichier-entrée
Charger les valeurs depuis un 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éparé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 le frontend Zabbix, "key" est la clé de l'élément cible et "value" la valeur à envoyer. Spécifiez - 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 du frontend Zabbix.
Zabbix sender enverra jusqu'à 250 valeurs dans une seule connexion.
La limite de taille pour l'envoi de valeurs depuis 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 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 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 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 dans le 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 une maintenance de type « aucune donnée », cette valeur sera ignoré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 séparées par des espaces : <hostname> <key> <timestamp> <ns> <value>.

Exemple de ligne dans le 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.

-g, --group
Regrouper les valeurs par hôtes et les envoyer à chaque hôte dans un lot séparé.

--tls-connect valeur
Comment se connecter au serveur ou au proxy. Valeurs :

[ ]{#lbAF}

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.

[ ]{#lbAG}

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.

[ ]{#lbAH}

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).

[ ]{#lbAI}