Rafael Martinez Guerrero - Senior Engineer at University of Oslo - "Zabbix-cli"

1. Lightning Talk – ZABBIX-CLI
Rafael Martinez Guerrero
Center for Information Technology Services
University of Oslo
Zabbix conference 2016
9-10 Sep. Riga, Latvia

5. /usr/bin/zabbix­cli
/usr/bin/zabbix­cli­init

6. zabbix­cli­init https://zabbix.example.org/

7. Configuration file:
$HOME/.zabbix­cli/zabbix­cli.conf
[.....]
system_id=PROD
logging=ON
[.....]
Logfile:
$HOME/.zabbix­cli/zabbix­cli.log

8. Interactive shell mode:
[user@host]# zabbix­cli
#############################################################
Welcome to the Zabbix command­line interface (v.1.5.4)
#############################################################
Type help or ? to list commands.
[zabbix­cli joshua@WOPR]$
Command­line mode:
[user@host]# zabbix­cli <param> ­C <command>
[user@host]# zabbix­cli ­­help

10. help <command_name>

11. [zabbix­cli joshua@WOPR]$ show_host
­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
# Host: zabbix­srv01.uio.no
# Filter:
­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
[....]
[zabbix­cli joshua@WOPR]$ show_host zabbix­
srv01.uio.no “”
[....]

12. [zabbix­cli joshua@WOPR]$ show_host zabbix*proxy* “”
[....]
[zabbix­cli joshua@WOPR]$ show_alarms *ICMP* “” “” “”
[zabbix­cli joshua@WOPR]$ show_alarms *ICMP* “” Role­
rhel5­servers,Role­rhel6­servers “”

13. [user@host]$ zabbix­cli ­o json ­C “show_host zabbix­srv01.uio.no ''”
{
"0": {
"groups": [
{
"groupid": "13",
"name": "All­hosts"
},
{
"groupid": "94",
"name": "Siteadmin­it­drift­gd­gid"
},
[...................]
{
"groupid": "108",
"name": "Role­rhel7­servers"
}
],
"host": "zabbix­srv01.uio.no",
"hostid": "10001",
"maintenance_status": "No maintenance (0)",
[.....................]

14. for HOST in
`zabbix-cli -o json -C "show_host *zabbix*proxy*" | jq -a '.[].host'`;
do
echo $HOST;
zabbix-cli -C "update_host_inventory $HOST type 'Zabbix proxy'";
done

15. [user@host]$ cat zabbix­bulk.txt
# HOSTGROUPS
create_hostgroup Zabbix­conf­test
#HOSTS
create_host zabbix­conf01.example.org Zabbix­conf­test .* 0
create_host zabbix­conf02.example.org Zabbix­conf­test .* 0
create_host zabbix­conf03.example.org Zabbix­conf­test .* 0
# TRIGGERS
link_template_to_host Template­icmp­ping zabbix­conf01.example.org
# DELETES
remove_host zabbix­conf01.example.org
remove_host zabbix­conf02.example.org
remove_host zabbix­conf03.example.org
[user@host]$ zabbix­cli ­­file zabbix­bulk.txt

16. Auth­file:
$HOME/.zabbix­cli_auth
Format:
USERNAME::PASSWORD
Token­file:
$HOME/.zabbix­cli_auth_token
Format:
USERNAME::SESSION_TOKEN
● OBS: .zabbix­cli_auth saves the password in plain text.
● Zabbix­cli saves the API­auth­token of a session in
$HOME/.zabbix­cli_auth_token only if use_auth_token_file=ON is
defined in the configuration file.

17. https://github.com/usit­gd/zabbix­cli