desmart/zabbix-agent

镜像概述和主要用途

本镜像基于zabbix/zabbix-agent:ubuntu-5.0-latest构建，在标准Zabbix Agent基础上集成了PostgreSQL客户端工具，主要用于对PostgreSQL数据库及相关系统资源进行监控。通过内置的PostgreSQL客户端，可直接执行数据库查询命令，实现对数据库性能指标、连接状态、查询效率等关键参数的采集与监控。

核心功能和特性

• 基础监控能力：继承Zabbix Agent 5.0的标准功能，支持系统资源（CPU、内存、磁盘、网络等）监控
• PostgreSQL客户端集成：内置PostgreSQL客户端工具，可直接执行psql等命令，实现数据库层面监控
• 兼容性：基于Ubuntu系统构建，与Zabbix Server 5.0及以上版本兼容
• 轻量级：在标准Zabbix Agent基础上最小化增加PostgreSQL客户端依赖，保持镜像精简

使用场景和适用范围

• 需对PostgreSQL数据库进行性能监控的企业IT环境
• 数据库服务器与系统资源一体化监控需求场景
• Zabbix监控体系中需要扩展数据库监控能力的部署环境
• 中小型PostgreSQL数据库集群的监控需求

使用方法和配置说明

环境变量配置

Docker部署示例

基本运行命令

bash
docker run -d \
  --name zabbix-agent-postgres \
  -e ZABBIX_SERVER_HOST=192.168.1.100 \
  -e HOSTNAME=postgres-server-01 \
  -e POSTGRES_HOST=192.168.1.101 \
  -e POSTGRES_USER=zabbix_monitor \
  -e POSTGRES_PASSWORD=SecurePass123 \
  -p 10050:10050 \
  --restart unless-stopped \
  [镜像名称]

挂载自定义配置文件

bash
docker run -d \
  --name zabbix-agent-postgres \
  -e ZABBIX_SERVER_HOST=192.168.1.100 \
  -v /etc/zabbix/zabbix_agentd.conf:/etc/zabbix/zabbix_agentd.conf \
  -v /etc/zabbix/zabbix_agentd.d:/etc/zabbix/zabbix_agentd.d \
  -p 10050:10050 \
  --restart unless-stopped \
  [镜像名称]

配置文件说明

为实现PostgreSQL监控，需在Zabbix Agent配置文件中添加相应监控项，示例配置（zabbix_agentd.d/postgres.conf）：

UserParameter=postgres.ping,psql -h $POSTGRES_HOST -p $POSTGRES_PORT -U $POSTGRES_USER -c "SELECT 1" >/dev/null 2>&1 && echo 1 || echo 0
UserParameter=postgres.connections,psql -h $POSTGRES_HOST -p $POSTGRES_PORT -U $POSTGRES_USER -t -c "SELECT count(*) FROM pg_stat_activity"
UserParameter=postgres.disk_usage,psql -h $POSTGRES_HOST -p $POSTGRES_PORT -U $POSTGRES_USER -t -c "SELECT pg_size_pretty(pg_database_size(current_database()))"

验证部署

部署后可通过Zabbix Server界面添加主机，并关联PostgreSQL监控模板，或执行以下命令验证Agent状态：

bash
docker exec zabbix-agent-postgres zabbix_agentd -t postgres.ping