This module will let you synchronize ansible hosts state with Zabbix. It means that it sets hosts via Zabbix API based on ansible variables:
Groups and Tempalates provided by ansible variables MUST be already present in Zabbix.
Web access from nodes managed by ansible to the Zabbix API should be allowed (firewall).
Make sure API user for provided credentials has enough permissions for host groups in Zabbix.
You can treat ansible inventory as an authoritative source of host information and sync it to Zabbix.
Tested on Zabbix 3.0.1.
None.
Available variables are listed below, along with default values (see defaults/main.yml
):
zabbix_default_group
- Default Zabbix group all hosts should belong to. Only hosts from this group are considered during synchronization (default "ansible").zabbix_templates
- Comma separated list of Zabbix templates the host should be linked to.zabbix_groups
- Comma separated list of Zabbix groups the host should belong to.zabbix_macros
- Comma separated list of Zabbix macros which should be added to the host. Odd items are macro keys, even items are macro values, eg.: '{$MACRO1},value1,{$MACRO2},value2'.zabbix_url
- Zabbix API URL.zabbix_user
and zabbix_password
- Zabbix API credentials.zabbix_basic_auth_user
and zabbix_basic_auth_password
- Optional basic AUTH credentials if required.zabbix_url: 'http://zabbixhost.com/api_jsonrpc.php'
zabbix_user: 'ansible'
zabbix_password: 'secretpassword'
zabbix_templates: 'mysql,nginx,php-fpm,LXC Containers,Web Test'
zabbix_groups: 'LXC Containers,Webservers'
zabbix_macros: '{$PAGE_STRING},Welcome on main page,{$SNMP_COMMUNITY},public'
- name: zabbix API
hosts: all
roles:
- role: r0bj.zabbix-api
MIT
This role was created in 2014 by Robert Jerzak.