OS Manuals

/usr/bin/zabbix_sender

FIPS-enabled Zabbix client utility for sending values to Zabbix server

From zabbix-sender-fips-7.4 7.4.16-r0 (enterprise-packages), captured 2026-11-08 by running zabbix_sender --help (exit 0). permalink

Usage:
  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] [-b] -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] -b] -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] [-b] -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] [-b] -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] [-b] -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] [-b] -i input-file
  zabbix_sender -h
  zabbix_sender -V

Utility for sending monitoring data to Zabbix server or proxy.

General options:
  -c --config config-file    Path to Zabbix agentd configuration file

  -z --zabbix-server server  Hostname or IP address of Zabbix server or proxy
                             to send data to. When used together with --config,
                             overrides the first entry of "ServerActive"
                             parameter specified in agentd configuration file

  -p --port port             Specify port number of trapper process of Zabbix
                             server or proxy. When used together with --config,
                             overrides the port of the first entry of
                             "ServerActive" parameter specified in agentd
                             configuration file (default: 10051)

  -I --source-address IP-address   Specify source IP address. When used
                             together with --config, overrides "SourceIP"
                             parameter specified in agentd configuration file

  -t --timeout seconds       Specify timeout. Valid range: 1-300 seconds
                             (default: 60 seconds)

  -s --host host             Specify host name the item belongs to (as
                             registered in Zabbix frontend). Host IP address
                             and DNS name will not work. When used together
                             with --config, overrides "Hostname" parameter
                             specified in agentd configuration file

  -k --key key               Specify item key
  -o --value value           Specify item value

  -i --input-file input-file   Load values from input file. Specify - for
                             standard input. Each line of file contains
                             whitespace delimited: <host> <key> <value>.
                             Specify - in <host> to use hostname from
                             configuration file or --host argument

  -T --with-timestamps       Each line of file contains whitespace delimited:
                             <host> <key> <timestamp> <value>. This can be used
                             with --input-file option. Timestamp should be
                             specified in Unix timestamp format

  -N --with-ns               Each line of file contains whitespace delimited:
                             <host> <key> <timestamp> <ns> <value>. This can be used
                             with --with-timestamps option

  -r --real-time             Send metrics one by one as soon as they are
                             received. This can be used when reading from
                             standard input

  -g --group                 Group values by hosts and send to each host in
                             a separate batch

  -v --verbose               Verbose mode, -vv for more details

  -h --help                  Display this help message
  -V --version               Display version number

TLS connection options:
  --tls-connect value        How to connect to server or proxy. Values:
                               unencrypted - connect without encryption
                                             (default)
                               psk         - connect using TLS and a pre-shared
                                             key
                               cert        - connect using TLS and a
                                             certificate

  --tls-ca-file CA-file      Full pathname of a file containing the top-level
                             CA(s) certificates for peer certificate
                             verification

  --tls-crl-file CRL-file    Full pathname of a file containing revoked
                             certificates

  --tls-server-cert-issuer cert-issuer   Allowed server certificate issuer

  --tls-server-cert-subject cert-subject   Allowed server certificate subject

  --tls-cert-file cert-file  Full pathname of a file containing the certificate
                             or certificate chain

  --tls-key-file key-file    Full pathname of a file containing the private key

  --tls-psk-identity PSK-identity   Unique, case sensitive string used to
                             identify the pre-shared key

  --tls-psk-file PSK-file    Full pathname of a file containing the pre-shared
                             key

  --tls-cipher13             Cipher string for OpenSSL 1.1.1 or newer for
                             TLS 1.3. Override the default ciphersuite
                             selection criteria. This option is not available
                             if OpenSSL version is less than 1.1.1

  --tls-cipher               GnuTLS priority string (for TLS 1.2 and up) or
                             OpenSSL cipher string (only for TLS 1.2).
                             Override the default ciphersuite selection
                             criteria

Example(s):
  zabbix_sender -z 127.0.0.1 -s "Linux DB3" -k db.connections -o 43

  zabbix_sender -z 127.0.0.1 -s "Linux DB3" -k db.connections -o 43 \
    --tls-connect cert --tls-ca-file /home/zabbix/zabbix_ca_file \
    --tls-server-cert-issuer \
    "CN=Signing CA,OU=IT operations,O=Example Corp,DC=example,DC=com" \
    --tls-server-cert-subject \
    "CN=Zabbix proxy,OU=IT operations,O=Example Corp,DC=example,DC=com" \
    --tls-cert-file /home/zabbix/zabbix_agentd.crt \
    --tls-key-file /home/zabbix/zabbix_agentd.key

  zabbix_sender -z 127.0.0.1 -s "Linux DB3" -k db.connections -o 43 \
    --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" \
    --tls-psk-file /home/zabbix/zabbix_agentd.psk

Report bugs to: <https://support.zabbix.com>
Zabbix home page: <https://www.zabbix.com>
Documentation: <https://www.zabbix.com/documentation>
Options (27)
OptionDescriptionSource
-c --configPath to Zabbix agentd configuration filehelp
-z --zabbix-serverHostname or IP address of Zabbix server or proxy to send data to.help
-p --portSpecify port number of trapper process of Zabbix server or proxy.help
-I --source-addressSpecify source IP address.help
-t --timeoutSpecify timeout.help
-s --hostSpecify host name the item belongs to (as registered in Zabbix frontend).help
-k --keySpecify item keyhelp
-o --valueSpecify item valuehelp
-i --input-fileLoad values from input file.help
-T --with-timestampsEach line of file contains whitespace delimited: <host> <key> <timestamp> <value>.help
-N --with-nsEach line of file contains whitespace delimited: <host> <key> <timestamp> <ns> <value>.help
-r --real-timeSend metrics one by one as soon as they are received.help
-g --groupGroup values by hosts and send to each host in a separate batchhelp
-v --verboseVerbose mode, -vv for more detailshelp
-h --helpDisplay this help messagehelp
-V --versionDisplay version numberhelp
--tls-connect valueHow to connect to server or proxy.help
--tls-ca-file CA-fileFull pathname of a file containing the top-level CA(s) certificates for peer certificate verificationhelp
--tls-crl-file CRL-fileFull pathname of a file containing revoked certificateshelp
--tls-server-cert-issuer cert-issuerAllowed server certificate issuerhelp
--tls-server-cert-subject cert-subjectAllowed server certificate subjecthelp
--tls-cert-file cert-fileFull pathname of a file containing the certificate or certificate chainhelp
--tls-key-file key-fileFull pathname of a file containing the private keyhelp
--tls-psk-identity PSK-identityUnique, case sensitive string used to identify the pre-shared keyhelp
--tls-psk-file PSK-fileFull pathname of a file containing the pre-shared keyhelp
--tls-cipher13Cipher string for OpenSSL 1.1.1 or newer for TLS 1.3.help
--tls-cipherGnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS 1.2).help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.