Skip to content

Zabbicook sets up your zabbix server according to the HOCON configuration file.

License

Notifications You must be signed in to change notification settings

rerorero/zabbicook

Repository files navigation

Zabbicook

Build Status MIT License

Zabbicook sets up your zabbix server according to the configuration file described in [Hocon] (https://github.com/typesafehub/config/blob/master/HOCON.md) format.
Some items of the setting have idempotency.

Requirements

  • JRE version: 8
  • Zabbix version: 3.0.x, 3.2.x

Getting Started

Please download the zip of [latest release] (https://github.com/rerorero/zabbicook/releases/latest) and unarchive it on the runtime environment.

unzip zabbicook-x.x.x.zip
cd zabbicook-x.x.x

zabbicook
# displays help

For Windows users, replace zabbicook with zabbicook.cmd.

# for windows
zabbicook.cmd

Let's add a new host group.
Suppose the zabbix server is running with localhost:8080.
To run zabbicook you need the user name and password of the zabbix administrator user.

cat << EOT > zabbicook.conf
hostGroups: [
  {name: "my group"}
]
EOT

zabbicook -f zabbicook.conf -i http://localhost:8080/ -u Admin -p zabbix

After checking the result of Succeed: total changes = 1, access http://localhost:8080/hostgroups.php in the browser and make sure that my groups has been added.

Setting file

Please look here for setting properties of the setting file to be passed to the -f (- file) option.
Unfortunately, not all settings of the zabbix server can be set, but only some of the setting items of the setting file.
You can also check items that can be set with the zabbicook --doc command in tree.
You can specify the root path of the tree with -r and the depth to display with -L.

Zabbicook --doc -r templates.items -L 1

Change zabbix user's password

Normally the user's password can be set in users in the configuration file, but Administrator users who run zabbicook can not be written in the configuration file.
You can set it in the browser in advance, or use the default user and password (Admin / zabbix).
That might bring security problems in a product environment, or you want to use it with ansible etc. you would like to automate this operation as well.
Zabbicook can change the zabbix user's password on the command line.

zabbicook --change-pass -i http://localhost:8080/ -u Admin -p zabbix --new-pass rDLz=a7w

About

Zabbicook sets up your zabbix server according to the HOCON configuration file.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages