# Overview

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

## Supported Operating Systems

| Operating System | Version |
| --- | ----- |
| Debian | 13 |
| SLES | 15 |
| Ubuntu | 22.04 LTS |
| 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:

```yaml
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:

```yaml
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.  

```yaml
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 |