interlegis/zabbix-agent

docker-zabbix-agentd

镜像概述和主要用途

docker-zabbix-agentd是一个基于Debian最新版本的Docker容器，用于在CoreOS实例中运行zabbix_agentd（Zabbix监控代理）。该镜像提供通过环境变量灵活配置Zabbix Agent参数的能力，适用于容器化环境下的监控代理部署。

核心功能和特性

• 环境变量驱动配置：前缀为"ZBX_CONF_"的环境变量会被自动写入配置文件/etc/zabbix/zabbix_agentd.d/80-env-generated.conf，可通过ZBX_CONFIGFILE环境变量自定义配置文件路径
• 参数映射机制：环境变量名去除"ZBX_CONF_"前缀后直接作为配置项，例如ZBX_CONF_ServerActive=proxy02,server01会生成ServerActive=proxy02,server01配置
• 多UserParameter支持：处理多个UserParameter设置时，会自动截断环境变量名末尾的"_[0-9]*"部分

使用场景和适用范围

适用于CoreOS环境中部署Zabbix Agent进行系统监控的场景，特别适合需要通过环境变量动态配置Agent参数的自动化部署流程，支持灵活调整监控配置。

使用方法和配置说明

通过cloud-config配置示例

在CoreOS中可通过cloud-config配置并启动服务：

#cloud-config

coreos:
  units:
    - name: zabbix-agentd.service
      command: start
      content: |
        [Unit]
        Description=Zabbix监控代理
        Documentation=https://www.zabbix.com/documentation/3.0/manual/concepts/agent
        [Service]
        ExecStartPre=/bin/sh -c 'cat >> /tmp/zabbix-agentd-env.txt <<<ZBX_CONF_Server=proxy02,server01'
        ExecStartPre=/bin/sh -c 'cat >> /tmp/zabbix-agentd-env.txt <<<ZBX_CONF_ServerActive=proxy02'
        ExecStartPre=/bin/sh -c 'cat >> /tmp/zabbix-agentd-env.txt <<<ZBX_CONF_EnableRemoteCommands=1'
        ExecStartPre=/bin/sh -c 'cat >> /tmp/zabbix-agentd-env.txt <<<ZBX_CONF_StartAgents=10'
        ExecStartPre=/bin/sh -c 'cat >> /tmp/zabbix-agentd-env.txt <<<ZBX_CONF_Timeout=30'
        ExecStartPre=/bin/sh -c 'cat >> /tmp/zabbix-agentd-env.txt <<<ZBX_CONF_Hostname=$(/bin/hostname -f)'
        ExecStart=/usr/bin/docker run --rm --env-file=/tmp/zabbix-agentd-env.txt --net=host --name zabbix-agentd godmodelabs/docker-zabbix-agentd:zabbix22
        ExecStop=-/usr/bin/docker stop zabbix-agentd
        ExecStopPost=-/bin/rm -f /tmp/zabbix-agentd-env.txt

关键配置参数

部署说明

容器需使用--net=host网络模式以确保监控数据正常采集，通过--env-file指定环境变量文件加载配置参数。服务停止时会自动清理临时环境变量文件，确保系统整洁。