Overview

This role the installation and configuration of the Zabbix Agent version 2.

Supported Operating Systems

Operating System	Version
Debian	12
SLES	15
Ubuntu	22.04 LTS
Ubuntu	24.04 LTS

Variables

Variable	Type	Default	Required
zabbix_proxy_address	string		Yes
zabbix_agent_hostinterface	string	inventory_hostname	No
zabbix_agent_hostname	string	inventory_hostname	No
zabbix_agent_psk_enable	bool	true	No
zabbix_agent_psk_id	string		Yes
zabbix_agent_psk	string(enc)		Yes
zabbix_user_sudo	bool	true	No

Example usage

With PSK:

zabbix_proxy_address: "proxy.monitor.localnet.internal"
zabbix_agent_psk_id: "client-psk"
zabbix_agent_psk: !vault
  $ANSIBLE_VAULT;1.1;AES256
  31633463613336373164373333633038393164383835646633303163316665303934646363383530
  ...

Without PSK:

zabbix_proxy_address: "proxy.monitor.localnet.internal"

DNS override

If DNS is complicated or permanently broken for some reason. We can override the hostname and hostinterface.
The hostname is the visible name in Zabbix.
The hostinterface is what Zabbix uses to connect to the host.

zabbix_agent_hostname: "server.example.com"
zabbix_agent_hostinterface: "192.168.10.10"

This is possible, but please only use if really required.

Tags

Tags	Purpose
zabbix_agent	Executes the whole playbook
zabbix_agent_config	Only manage Zabbix Agent 2 configuration
zabbix_agent_install	Only manage Zabbix Agent 2 installation
zabbix_agent_prereq	Only manage Zabbix Agent 2 prerequisites