Simon Cornet
5aaf6a11f3
All checks were successful
ci/woodpecker/push/linting Pipeline was successful
2.6 KiB
2.6 KiB
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_enableis set totrue.
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 |