kvaps/zabbix-agent

docker-zabbix-agent

镜像概述和主要用途

docker-zabbix-agent是一个容器化的zabbix-agent解决方案，集成了iostat指标扩展（基于https://github.com/lesovsky/zabbix-extensions/tree/master/files/iostat%EF%BC%89%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E6%8F%90%E4%BE%9B%E4%BA%86%E4%BE%BF%E6%8D%B7%E7%9A%84%E7%B3%BB%E7%BB%9F%E7%9B%91%E6%8E%A7%E8%83%BD%E5%8A%9B%EF%BC%8C%E5%8F%AF%E6%94%B6%E9%9B%86%E6%9C%8D%E5%8A%A1%E5%99%A8%E6%80%A7%E8%83%BD%E6%95%B0%E6%8D%AE%EF%BC%8C%E7%89%B9%E5%88%AB%E9%80%82%E7%94%A8%E4%BA%8E%E9%9C%80%E8%A6%81%E7%9B%91%E6%8E%A7%E7%A3%81%E7%9B%98I/O%E6%80%A7%E8%83%BD%E7%9A%84%E5%9C%BA%E6%99%AF%EF%BC%8C%E5%B9%B6%E6%94%AF%E6%8C%81%E5%9C%A8Docker%E5%92%8CKubernetes%E7%8E%AF%E5%A2%83%E4%B8%AD%E9%83%A8%E7%BD%B2%E3%80%82

核心功能和特性

• 容器化部署：将zabbix-agent封装为Docker镜像，简化部署和管理流程
• iostat指标支持：集成iostat扩展，可收集磁盘I/O性能指标
• 灵活配置：支持通过挂载自定义配置文件调整监控参数
• 多环境兼容：同时支持Docker单机部署和Kubernetes集群部署
• 系统级监控：通过特权模式和主机网络模式获取完整的系统监控数据

使用场景和适用范围

• 服务器系统性能监控需求
• Docker容器环境中的主机监控
• Kubernetes集群节点性能数据采集
• 需要磁盘I/O性能指标的监控场景
• 快速部署zabbix-agent的临时监控需求

使用方法和配置说明

Docker部署

1. 获取默认配置文件

首先从镜像中提取默认配置文件：

bash
docker run --rm -v ${PWD}:/pwd -ti zabbix-agent cp /etc/zabbix/zabbix_agentd.conf /pwd/

2. 编辑配置文件

根据实际监控需求修改zabbix_agentd.conf，主要配置项包括：

• Server：Zabbix服务器地址
• ServerActive：主动模式下的Zabbix服务器地址
• Hostname：当前监控节点的主机名

3. 启动容器

使用以下命令运行zabbix-agent容器：

bash
docker run -ti --privileged -v ${PWD}/zabbix_agentd.conf:/etc/zabbix/zabbix_agentd.conf -v /dev:/dev --net=host -ti zabbix-agent

参数说明：

• --privileged：赋予容器特权模式，确保能获取系统级信息
• -v ${PWD}/zabbix_agentd.conf:/etc/zabbix/zabbix_agentd.conf：挂载自定义配置文件
• -v /dev:/dev：挂载设备目录，支持iostat指标采集
• --net=host：使用主机网络模式，确保监控数据的准确性

Kubernetes部署

通过DaemonSet确保集群中每个节点都运行一个zabbix-agent实例：

1. 应用DaemonSet配置

bash
kubectl apply -f https://raw.githubusercontent.com/kvaps/docker-zabbix-agent/master/zabbix-agent.yaml

2. 配置说明

DaemonSet配置文件（zabbix-agent.yaml）包含以下关键配置：

• 使用主机网络模式
• 挂载主机的/dev目录
• 以特权模式运行
• 通过ConfigMap或Secret管理zabbix-agent配置

注：可根据实际需求修改DaemonSet配置，如调整资源限制、添加环境变量或修改配置参数。