southbridgeio / zabbix-review-export-import

Clone of zabbix-review-export with added import object(s) feature
https://gitlab.com/devopshq/zabbix-review-export
50 stars 30 forks source link
cicd export gitlab import review zabbix

Zabbix Review and Export/Import

With Zabbix review and export (backup)/import you can create review mechanism and save/restore zabbix configuration as code (Monitoring as Code)

You can export (backup) all hosts templates and other object with zabbix-export.py script.

You can also import (restore) many types of zabbix objects from YAML dump with zabbix-import.py script (note that order of import is matters, i.e., you cant add user if there is no mediatype for them, etc...). Already existed objects will be skipped. Object type is autodetected, but may be pointed manually (it is much faster for single-file import operations)/

Requirements

If you want use review (or Monitoring as Code:

Make export and backup

It's simple to start use this script as backup mechanism:

# git clone THIS_REPO or download and unpack archive

python -mpip install -r requirements.txt

# smoke test :)
python ./zabbix-export.py --help

# backup to current folder, save XML and JSON
python ./zabbix-export.py --zabbix-url https://zabbix.example.com --zabbix-username user --zabbix-password password

# backup only hosts in YAML format
python ./zabbix-export.py --save-yaml --zabbix-url https://zabbix.example.com --zabbix-username user --zabbix-password password --only hosts

# backup to custom folder in YAML format
python ./zabbix-export.py --save-yaml --directory /home/username/path/to/zabbix-yaml --zabbix-url https://zabbix.example.com --zabbix-username user --zabbix-password password

Restore from YAML dump

Few examples:

export ZABBIX_URL="https://zabbix.instan.ce"
export ZABBIX_USERNAME="user.name"
export ZABBIX_PASSWORD="secret"

./zabbix-import.py /path/to/file.yaml

./zabbix-import.py --type host /path/fo/repo/hosts/*

Make review

You want to make review (Moniroting as Code). Read more on habr.com: RU, EN translated

  1. Fork this repository to you GitLab account or instance (e.g. groupname/zabbix-review-export)
  2. Create repository where will be saved XML and YAML (e.g. two repositories groupname/zabbix-xml and groupname/zabbix-yaml. Do first (init) commit (create empty README.md).
  3. Create two branches in this repos: master and develop. In repository groupname/zabbix-xml set develop as a default branch.
  4. Specify Project Variables for all variables, specified on top of .gitlab-ci.yml
  5. Change jobs in .gitlab-ci.yml and leave the ones you need job in .gitlab-ci.yml and change to you environment (see commented examples block).
  6. Try to run manual job YAML zabbix
  7. Create merge request develop=>master in zabbix-yaml. For first time you can merge without review, it's too hard :)
  8. Configure Schedule (eg. every week)
  9. Change some host, template or other supported objects in zabbix, run manual job and create merge request again. Enjoy!

Notes

Use two repositories for XML+JSON (raw-format) and readable YAML format:

Create empty merge request develop=>master after merge and receive notifications at changes (schedule or manual jobs run) on your email.

To answer for the question "Who make this changes?" you need use Zabbix Audit. It's difficult but possible.

Supported objects

Use standard zabbix export functional:

Representing objects as JSON using the API:

Known issues

Screenshots

YAML change action: yaml-change-action.png

YAML change trigger expression: yaml-change-trigger-expression.png

YAML link template yaml-link-template.jpg

XML change templates (but we recommend use YAML for review and XML only for backup): xml-change-templates.jpg