一、Docker插件配置 file (docker.conf)
#vi docker.conf
请注意：
默认值反映进程默认值，而不是随配置文件提供的值；
Zabbix 仅支持使用 UTF-8 编码且不带 BOM 的配置文件；
以 "#" 开头的注释仅支持位于行首。
|-------------------------|------------|------------|-----------------------------|-------------------------------------------------------|
| 参数 | 必填 | 范围 | 默认值 | 说明 |
| Plugins.Docker.Endpoint | no | | unix:///var/run/docker.sock | Docker 守护进程 unix-socket 位置。 必须包含 scheme（仅支持 unix://）。 |
| Plugins.Docker.Timeout | no | 1-30 | 全局超时时间 | 请求执行超时时间（单位为秒，表示在关闭请求之前等待其完成的时长）。 |
二、启动agent2
docker run --name docker-agent2 -e TZ=Asia/Shanghai -e ZBX_HOSTNAME="docker_204" -e ZBX_SERVER_HOST="172.22.0.1" -e ZBX_SERVER_PORT="10051" --network=sinops_network -p 10053:10050 -v /home/third_party_app/zbx_instance/zabbix-agent2/zabbix:/etc/zabbix --restart unless-stopped -v /var/run/docker.sock:/var/run/docker.sock:ro --group-add $(stat -c %g /var/run/docker.sock) -d zabbix/zabbix-agent2:ubuntu-7.0-latest
注：
-v /var/run/docker.sock:/var/run/docker.sock:ro 挂载 Docker Socket（只读），用于访问 API
-e ZBX_HOSTNAME="docker_204" 在 Zabbix Server 中添加主机时使用的主机名（必须一致）
-e ZBX_SERVER_HOST="172.22.0.1" sinops_network 的网关。
关键参数：--group-add $(stat -c %g /var/run/docker.sock)
它会自动获取宿主机 docker.sock 的组 ID（通常是984或 docker 组），并把容器内的 zabbix 用户加入该组。
2.1容器里面查看docker版本
zabbix_agent2 -t docker.info
docker.info s\|{"Id":"90686664-e6f2-4b35-8bf4-dcfcbfd2cfc5","Containers":26,"ContainersRunning":25,"ContainersPaused":0,"ContainersStopped":1,"Images":40,"Driver":"overlay2","MemoryLimit":true,"SwapLimit":true,"KernelMemory":false,"KernelMemoryTCP":false,"CpuCfsPeriod":true,"CpuCfsQuota":true,"CPUShares":true,"CPUSet":true,"PidsLimit":true,"IPv4Forwarding":true,"BridgeNfIptables":false,"BridgeNfIP6tables":false,"Debug":false,"NFd":318,"OomKillDisable":false,"NGoroutines":307,"LoggingDriver":"json-file","CgroupDriver":"systemd","NEventsListener":0,"KernelVersion":"6.14.0-29-generic","OperatingSystem":"Ubuntu 24.04.2 LTS","OSVersion":"24.04","OSType":"linux","Architecture":"x86_64","IndexServerAddress":"https://index.docker.io/v1/","NCPU":56,"MemTotal":135053045760,"DockerRootDir":"/home/third_party_app/docker","Name":"master","ExperimentalBuild":false,"ServerVersion":"28.2.2","ClusterStore":"","ClusterAdvertise":"","DefaultRuntime":"runc","LiveRestoreEnabled":false,"InitBinary":"docker-init","SecurityOptions":\["name=apparmor","name=seccomp,profile=builtin","name=cgroupns","Warnings":null}]
2.2监控效果
三、zabbix agent连接图
Zabbix agent 2 在 Linux 上通过 UNIX 套接字、在 Windows 上通过命名管道与插件进行双向连接。
下图展示了 Zabbix agent 2 与可加载插件之间的通信过程以及指标收集过程。
四、疑问
进入容器时报groups: cannot find name for group ID 984，但Zabbix 能正常监控 Docker，这是为什么？
权限判定依据是：进程的有效 GID 是否匹配 /var/run/docker.sock 的组
/var/run/docker.sock 属于 root:984，权限为 srw-rw----
容器中 zabbix 用户的附加组包含 GID 984（即使没有名字）
所以 zabbix 进程有 读写权限，可以连接 Docker Daemon
结论：组名只是"别名"，权限看的是 GID 数字
ls -l /var/run/docker.sock
