Overview

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

Supported Operating Systems

Operating System	Version
Alpine	3.23
Debian	13
SLES	15
Ubuntu	24.04 LTS

Variables

Variable	Type	Default	Required
zabbix_agent_hostinterface	string	inventory_hostname	No
zabbix_agent_hostname	string	inventory_hostname	No
zabbix_agent_listen_port	string	10050	No
zabbix_agent_psk_enable	bool	true	No
zabbix_agent_psk_id	string		Yes*
zabbix_agent_psk	string(enc)		Yes*
zabbix_proxy_address	string	shared.proxy.monitor.itcreation.tools	No
zabbix_proxy_port	string	10051	No
zabbix_user_sudo	bool	true	No

• Only if zabbix_agent_psk_enable is set to true.

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

If you call the role without tags, it will execute all of the stages bellow.

Tags	Purpose
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