Zabbix-cli is a command line interface for performing common administrative tasks tasks in Zabbix monitoring system via the Zabbix API.
The zabbix-cli code is written in Python and distributed under the GNU General Public License v3. It has been developed and tested by University Center for Information Technology at the University of Oslo, Norway.
The project home page is on GitHub. Please report any issues or improvements there.
The manual is available on-line at https://unioslo.github.io/zabbix-cli/manual.html.
There are versioned deb and rpm releases available on the GitHub releases page.
You could also install directly from GitHub with pip:
pip install git https://github.com/unioslo/zabbix-cli.git@master
Zabbix-cli need a config file. This can be created with the zabbix-cli-init
command.
zabbix-cli-init --zabbix-url https://zabbix.example.com/
Zabbix-cli will look for config files in the following order. Any later files will override the former:
- /usr/share/zabbix-cli/zabbix-cli.conf
- /etc/zabbix-cli/zabbix-cli.conf
- ~/.zabbix-cli/zabbix-cli.conf
- File spesified with
-c
/--config
parameter - /etc/zabbix-cli/zabbix-cli.fixed.conf
- /usr/share/zabbix-cli/zabbix-cli.fixed.conf
By running the config module you will get the current config or the default config:
python -m zabbix_cli.config show
python -m zabbix_cli.config defaults
If you run into problems it is usefull to enable logging and set the DEBUG
level for logging:
[logging]
logging = ON
log_level = DEBUG
log_file = /path/to/log/zabbix-cli.log
By default you will be asked for a username and password when running zabbix-cli.
Alternatively you could store your username and password in the file ~/.zabbix-cli_auth
. The content of this file will need to be on the USERNAME::PASSWORD
format.
A third alternative is using the environment variables, ZABBIX_USERNAME
and ZABBIX_PASSWORD
.
You need to secure this authentication file and need to be aware that other processes on the same computer will be able to view your environment variables. Use these features at your own risk.
Zabbix-cli will store a session token if you configure use_auth_token_file = ON
. This way you don't need to provide your credentials each time you run zabbix-cli. This token file should also be secured properly.
You may run zabbix-cli as a shell/REPL by simply running zabbix-cli
.
A single command could be run by using the -C
/--command
parameter like zabbix-cli -C "show_host host.example.com"
.
Alternatively you could run multiple commands if you provide a file, with the -f
parameter, with one command per line in the file.
Get more help and information by running zabbix-cli --help
and zabbix-cli -C "help"
.