17.4 Zabbix 监控（基于 PostgreSQL）

安装 zabbix7-server

zabbix7-server 是服务器端（Zabbix Server）。它负责接收和处理监控数据，应安装在监控服务器上。

使用 pkg 安装会额外安装 MySQL，并可能导致绑定冲突，因此推荐使用 Ports 安装：

# cd /usr/ports/net-mgmt/zabbix7-server/ 
# make config

按如图配置，选中 PGSQL 后按回车键：

# make install clean

安装 PostgreSQL

请读者自行完成 PostgreSQL 16 的安装、初始化及服务自启。

安装 Nginx

请读者自行完成 Nginx 的安装和服务自启。

安装 zabbix7-frontend

zabbix7-frontend 是 Web 控制前端（Zabbix Frontend）。

使用 pkg 安装：

# pkg ins zabbix7-frontend-php83

上述安装过程会自动安装 PHP，本文中安装的版本是 PHP8.3（写作本文时 PHP8.4 会报错），具体可用版本可以到 zabbix7-frontend 看一下。

或者使用 ports 安装：

# cd /usr/ports/net-mgmt/zabbix7-frontend/ 
# make install clean

PDO

注意所使用的 PHP 版本要与 Zabbix 前端兼容。

使用 pkg 安装：

# pkg ins php83-pdo_pgsql php83-pgsql

或者使用 ports 安装：

# cd /usr/ports/databases/php83-pdo_pgsql/ && make install clean
# cd /usr/ports/databases/php83-pgsql/ && make install clean

安装 zabbix7-agent

zabbix7-agent 负责收集监控数据，应安装在被监控的服务器上。

使用 pkg 安装：

# pkg install zabbix7-agent

或者使用 ports 安装：

# cd /usr/ports/net-mgmt/zabbix7-agent/ 
# make install clean

守护进程

# service zabbix_server enable   # 设置 Zabbix Server 服务开机自启
# service zabbix_agentd enable   # 设置 Zabbix Agent 服务开机自启
# service php_fpm enable         # 设置 PHP-FPM 服务开机自启

设置 PostgreSQL 数据库

请读者自行初始化 PostgreSQL 数据库后再执行以下命令：

$ cd /usr/local/share/zabbix7/server/database/postgresql/             # 进入 Zabbix PostgreSQL 数据库初始化脚本目录
$ psql                                     # 启动 PostgreSQL 命令行客户端
psql (16.8)
Type "help" for help.

template1=# create database zabbix;                 -- 创建 zabbix 数据库
CREATE DATABASE

template1=# CREATE USER zabbix WITH PASSWORD 'z';  -- 创建用户 zabbix 并设置密码为 'z'
CREATE ROLE

postgres=# GRANT USAGE, CREATE on SCHEMA public to zabbix;  -- 授权 zabbix 用户使用 public 模式并创建对象
GRANT

postgres=# GRANT ALL PRIVILEGES ON DATABASE zabbix TO zabbix;  -- 授权 zabbix 用户对 zabbix 数据库所有权限
GRANT

postgres=# ALTER DATABASE zabbix owner to zabbix;   -- 将 zabbix 数据库所有权转给 zabbix 用户
ALTER DATABASE

postgres=# \q                                     -- 退出 PostgreSQL 命令行

必须退出再继续：

$  psql -U zabbix zabbix -- 使用用户账户 zabbix 登录到数据库 zabbix
psql (16.8, server 16.7)
Type "help" for help.

zabbix=> \i schema.sql -- 在 zabbix 数据库中执行 schema.sql 脚本以创建数据库结构
CREATE TABLE
CREATE INDEX
CREATE TABLE
CREATE INDEX
CREATE TABLE

……此处省略部分输出……

zabbix=> \i images.sql
INSERT 0 1
INSERT 0 1
INSERT 0 1
INSERT 0 1
INSERT 0 1

……此处省略部分输出……

zabbix=>  \i data.sql
START TRANSACTION
INSERT 0 4
INSERT 0 1
INSERT 0 2

……此处省略部分输出……

zabbix=# \q -- 退出
$ exit # 退出数据库用户
root@ykla:~ # # 返回到 root 用户

参考文献

• PostgreSQL15 Public Schema 没有权限问题解决

设置 Zabbix Server

Zabbix Server 的主要配置文件位于 /usr/local/etc/zabbix7/zabbix_server.conf。

加入以下内容：

SourceIP=127.0.0.1           # Zabbix Server 监听的源 IP 地址
LogFile=/var/log/zabbix/zabbix_server.log   # Zabbix Server 日志文件路径
DBHost=                        # 数据库主机地址，留空表示本地主机
DBName=zabbix                  # Zabbix Server 使用的数据库名称
DBUser=zabbix                  # 数据库用户名
DBPassword=z                   # 数据库用户密码
Timeout=4                      # Zabbix Server 与数据库或代理的超时时间（秒）
LogSlowQueries=3000            # 记录超过指定毫秒数的慢查询
StatsAllowedIP=127.0.0.1       # 允许访问 Zabbix Server 统计信息的 IP

设置 Zabbix Agent

Zabbix Agent 的配置文件位于 /usr/local/etc/zabbix7/zabbix_agentd.conf。

加入以下内容：

LogFile=/var/log/zabbix/zabbix_agentd.log   # Zabbix Agent 日志文件路径
SourceIP=127.0.0.1                          # Zabbix Agent 使用的源 IP 地址
Server=127.0.0.1                            # Zabbix Server IP 地址，用于被动检查
ServerActive=127.0.0.1                      # Zabbix Server IP 地址，用于主动检查
Hostname=ykla                               # 当前主机在 Zabbix Server 中的主机名

配置 Zabbix 前端

Zabbix 前端配置文件模板位于 /usr/local/www/zabbix7/conf/zabbix.conf.php.example（Zabbix Frontend 配置模板）。

复制 Zabbix 示例配置文件为正式配置文件：

# cp /usr/local/www/zabbix7/conf/zabbix.conf.php.example /usr/local/www/zabbix7/conf/zabbix.conf.php

编辑 /usr/local/www/zabbix7/conf/zabbix.conf.php，将：

$DB['TYPE']                             = 'MYSQL';
$DB['SERVER']                   = 'localhost';
$DB['PORT']                             = '0';
$DB['DATABASE']                 = 'zabbix';
$DB['USER']                             = 'zabbix';
$DB['PASSWORD']                 = '';

修改如下：

$DB['TYPE']     = 'POSTGRESQL';   # 数据库类型设置为 PostgreSQL
$DB['SERVER']   = 'localhost';    # 数据库服务器地址
$DB['PORT']     = '0';            # 数据库端口，0 表示使用默认端口
$DB['DATABASE'] = 'zabbix';       # 数据库名称
$DB['USER']     = 'zabbix';       # 数据库用户名
$DB['PASSWORD'] = 'z';            # 数据库用户密码

配置 nginx

备份原有 Nginx 主配置文件：

# cp /usr/local/etc/nginx/nginx.conf /usr/local/etc/nginx/nginx.conf.simple

编辑 /usr/local/etc/nginx/nginx.conf 文件，清空原有内容，修改如下，

worker_processes 1;                              # 工作进程数量
events {
  worker_connections 1024;                       # 单个工作进程允许的最大连接数
}
http {
  include             mime.types;                # 引入 MIME 类型定义文件
  default_type        application/octet-stream; # 默认 MIME 类型
  sendfile            on;                        # 启用 sendfile 提高静态文件传输效率
  keepalive_timeout   65;                        # keepalive 超时时间（秒）
  server {
    listen            80;                        # 监听 HTTP 80 端口
    server_name       localhost;                 # 虚拟主机名称
    root /usr/local/www/zabbix7;                # 网站根目录
    index index.php index.html index.htm;        # 默认首页文件顺序
    location / {
      try_files $uri $uri/ =404;                # 请求文件不存在时返回 404
    }
    location ~ .php$ {                           # 匹配 .php 文件请求
      fastcgi_split_path_info ^(.+\.php)(/.+)$; # 分割 PATH_INFO
      fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; # PHP 脚本路径
      fastcgi_param PATH_INFO $fastcgi_path_info;                         # 设置 PATH_INFO
      fastcgi_param REMOTE_USER $remote_user;                             # 设置 REMOTE_USER
      fastcgi_pass   127.0.0.1:9000;                                      # FastCGI 服务地址
      fastcgi_index index.php;                                            # 默认 FastCGI 索引文件
      include fastcgi_params;                                             # 引入 FastCGI 参数文件
    }
  }
}

配置 PHP

编辑 /usr/local/etc/php.ini-production 文件

将生产环境 PHP 配置文件复制为默认配置文件：

# cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini

编辑 /usr/local/etc/php.ini 文件：

• 找到 ;date.timezone = 修改为 date.timezone = Asia/Shanghai（注意要删掉原来开头的 ;）

• 找到 post_max_size = 8M 修改为 post_max_size = 16M

• 找到 max_execution_time = 30，修改为 max_execution_time = 300

• 找到 max_input_time = 60，修改为 max_input_time = 300

启动服务

# service postgresql restart    # 重启 PostgreSQL 服务
# service php_fpm start         # 启动 PHP-FPM 服务
# service nginx start           # 启动 Nginx 服务
# service zabbix_server start   # 启动 Zabbix Server 服务
# service zabbix_agentd start   # 启动 Zabbix Agent 服务

登录

Zabbix Web 前端的默认用户名和密码如下：

• 用户名：Admin

• 密码：zabbix

配置中文

故障排除与未竟事宜

日志

• 代理：/var/log/zabbix/zabbix_agentd.log

• 服务器端：/var/log/zabbix/zabbix_server.log

• PHP 相关错误：/var/log/nginx/error.log

待解决

• 中文显示乱码

• 部分监控项未显示

• HTTP 等安全配置待完善

参考文献

• Monitor Your Hosts with Zabbix