About

Zabbix-auto-config is an utility that aims to automatically configure hosts, host groups, host inventories and templates in the monitoring software Zabbix.

Note: This is only tested with Zabbix 5.0 LTS.

Quick start

This is a crash course in how to quickly get this application up and running in a local test environment:

Containers

Use podman. Beware: There is a bug in podman 2.2.x. Use older/newer version.

ZABBIX_PASSWORD=secret envsubst < zabbix.template.yaml > zabbix.yaml
podman play kube zabbix.yaml

Zabbix web

It is currently assumed that you have the following hostgroups in Zabbix. You should logon to Zabbix and create them:

• All-auto-disabled-hosts
• All-hosts

For automatic linking in templates you could create the templates:

• Template-barry
• Template-pizza

Database

PGPASSWORD=secret psql -h localhost -U postgres -p 5432 -U zabbix << EOF
CREATE DATABASE zac;
\c zac
CREATE TABLE hosts (
    data jsonb
);
CREATE TABLE hosts_source (
    data jsonb
);
EOF

Application

python3 -m venv venv
. venv/bin/activate
pip install -e .
cat config.sample.ini > config.ini
sed -i 's/^dryrun = true$/dryrun = false/g' config.ini
mkdir -p /path/to/source_collector_dir/ /path/to/host_modifier_dir/ /path/to/map_dir/
cat > /path/to/source_collector_dir/mysource.py << EOF
HOSTS = [
    {
        "hostname": "foo.example.com",
    },
    {
        "hostname": "bar.example.com",
    },
]

def collect(*args, **kwargs):
    for host in HOSTS:
        host["enabled"] = True
        host["siteadmins"] = ["bob@example.com"]
        host["properties"] = ["pizza"]
        source = kwargs.get("source")
        if source:
            host["properties"].append(source)

    return HOSTS
EOF
cat > /path/to/host_modifier_dir/mod.py << EOF
def modify(host):
    if host["hostname"] == "bar.example.com":
        host["properties"].append("barry")
        host["properties"] = sorted(host["properties"])
    return host
EOF
cat > /path/to/map_dir/property_template_map.txt << EOF
pizza:Template-pizza
barry:Template-barry
EOF
cat > /path/to/map_dir/property_hostgroup_map.txt << EOF
other:Hostgroup-other-hosts
EOF
cat > /path/to/map_dir/siteadmin_hostgroup_map.txt << EOF
bob@example.com:Hostgroup-bob-hosts
EOF

Run the application:

zac

Systemd unit

You could run this as a systemd service:

[Unit]
Description=Zabbix auto config
After=network.target

[Service]
User=zabbix
Group=zabbix
WorkingDirectory=/home/zabbix/zabbix-auto-config
Environment=PATH=/home/zabbix/zabbix-auto-config/venv/bin
ExecStart=/home/zabbix/zabbix-auto-config/venv/bin/zac
TimeoutSec=300

[Install]
WantedBy=multi-user.target

Host inventory

Zac manages only inventory properties configured as managed_inventory in config.ini. Inventory properties must be seperated by ",". An inventory property will not be removed/blanked from Zabbix even if the inventory property is removed from managed_inventory list or from the host in the source e.g:

1. Add "location=x" to a host in a source and wait for sync
2. Remove the "location" property from the host in the source
3. "location=x" will remain in Zabbix