Docker部署Zabbix Agent2监控容器遇docker.service未激活问题

核心原因 #

Zabbix提示docker.service未处于激活状态，大概率是因为Agent2默认尝试通过systemd查询服务状态，但容器内即使开启privileged和pid:host，也可能因权限、宿主机init系统差异，或未正确配置Docker监控项导致失效。以下是针对性解决方案：

1. 改用Docker Socket直接监控状态 #

放弃依赖systemd的docker.service状态查询，改用通过/var/run/docker.sock直接获取Docker daemon状态的监控项：

• 在Zabbix前端创建监控项，使用内置键值docker.info，该键值会直接通过socket查询Docker daemon的运行状态
• 或者自定义UserParameter，在Agent2配置目录（对应宿主机${ZBX_FOLDER}/etc/zabbix/zabbix_agentd.d）添加文件docker.conf：

UserParameter=docker.status,/usr/bin/docker info >/dev/null 2>&1 && echo 1 || echo 0

重启Agent2容器后，在Zabbix前端添加该自定义键值的监控项，值为1表示Docker正常运行。

2. 修复容器内访问Docker Socket的权限 #

即使挂载了/var/run/docker.sock，容器内的zabbix用户可能没有访问权限：

• 临时方案（便捷但略不安全）：修改宿主机socket权限

sudo chmod 666 /var/run/docker.sock

• 安全方案：将容器内用户加入宿主机docker组
  1. 查看宿主机docker组的GID：

  getent group docker | cut -d: -f3
  

  2. 在docker-compose.yml的zabbix-agent服务中添加group_add配置（替换成上一步获取的GID，比如999）：

  services:
    zabbix-agent:
      # 其他配置不变
      group_add:
        - "999"
  

3. 验证PID命名空间共享是否生效 #

如果坚持要通过systemd查询docker.service状态，需确保pid:host配置生效：

1. 进入Agent2容器，查看是否能看到宿主机的systemd进程：

docker exec -it <你的Agent容器名> ps aux | grep systemd

2. 如果看不到，检查宿主机是否使用systemd作为init系统（部分轻量发行版用openrc等），若宿主机不使用systemd，此方式完全不可行，必须改用方案1。

4. 检查Agent2日志排查细节 #

查看Agent2日志，定位具体错误：

docker exec -it <你的Agent容器名> tail -f /var/log/zabbix/zabbix_agent2.log

如果日志中出现permission denied类错误，优先处理权限问题（方案2）；如果出现cannot connect to Docker daemon，检查socket路径是否正确挂载。

内容的提问来源于stack exchange，提问作者Keonik