Zabbix 指标

ONE平台支持通过API访问方式和Webhook推送两种方式来收集Zabbix系统的指标数据。

前置条件

模式	要求
API	Zabbix ≤ 6.0
Webhook 推送	Zabbix ≤ 6.0（通过文件导出，性能更高）
网络	ONE 平台必须能访问 Zabbix 服务器

开始使用

API方式获取指标

进入数据集成 -> 数据接入页面，找到Zabbix数据接入卡片，点击开始集成，选择API获取Zabbix Item监控项。

需要提供Zabbix相关的API参数，以官方说明为准，可参考以下文档。

Zabbix API官方文档：

https://www.zabbix.com/documentation/4.2/zh/manual/appendix

Zabbix API获取方式：

https://www.zabbix.com/documentation/current/zh/manual/api#%E6%A6%82%E8%A7%88

其他参数

• 数据周期：每隔多少秒访问一次Zabbix API以获取数据，频繁发起API请求会影响zabbix服务本身，推荐间隔在15秒到30秒之间。

• 数据起始时间：收集数据的最早时间。

• 唯一标签：用以识别数据的来源是哪个Zabbix服务。

Webhook方式获取指标

进入数据集成 -> 数据接入页面，找到Zabbix数据接入卡片，点击开始集成，选择Webhook获取Zabbix Item监控项。

ONE平台提供了单独的工具来获取Zabbix数据，并将数据通过Webhook方式推送到ONE平台。工具通过Zabbix转文件方式获取指标数据，并通过定时请求API获取Item的实体信息。

• 寻找Zabbix Server配置文件的位置。

ps -ef |grep zabbix_server.conf

• 在配置文件中添加导出配置。

# zabbix实时导出数据文件所在目录
ExportDir=/data/br/data/zabbix    
# zabbix实时导出数据文件大小
ExportFileSize=1G    

• 查看Zabbix Server进行所属的用户，给该用户赋予ExportDir文件夹读写权限。

ps -ef |grep "/etc/zabbix/zabbix_server.conf"
zabbix    9746     1  0 16:03 ?        00:00:00 /usr/sbin/zabbix_server -c /etc/zabbix/zabbix_server.conf

# 可以看出用户是zabbix，则给用户zabbix赋予对ExportDir文件夹的读写权限：
chown zabbix:zabbix -R /data/br/data/zabbix
chmod u+rw -R /data/br/data/zabbix

• 重启Zabbix Server

service restart zabbix-server
或
systemctl restart zabbix-server

• 将zabbix-realtime-export.zip上传到Zabbix Server服务端，并解压到某个目录，比如/home/zabbix/export。

• 将ONE中获取到的Zabbix Webhook指标推送地址配置到config.yml中service模块下。

• 配置zabbix API拉取的路径zabbix.apiServer和用户名zabbix.username密码zabbix.password，配置zabbix实时导出路径zabbix.exportDir也即上面在zabbix_server.conf中配置的路径（以及zabbix_server.conf所在路径）。

提示

• 前端路径 http://ip/xxx/zabbix.php这种格式，apiServer配置成：http://127.0.0.1/xxx/api_jsonrpc.php。
• 如果前端路径是http://ip/zabbix.php这种格式，相应的apiServer中的xxx也要去掉，也即apiServer配置成：http://127.0.0.1/api_jsonrpc.php

# zabbix api相关配置
zabbix:
  apiServer: http://127.0.0.1/zabbix/api_jsonrpc.php
  username: Admin
  password: zabbix
  refreshIntervalHours: 6
# zabbix实时导出协议相关配置
export:
  exportDir: /data/br/data/zabbix
  zabbixServerConfPath: /etc/zabbix/zabbix_server.conf
# 导出服务相关配置
service:
  pollingIntervalInMillis: 50
  readFileBufferInMB: 2
  checkpointPath: ./checkpoint
  checkpointSync: true
  initialFlushDelaySeconds: 1
  flushDelaySeconds: 1
  sendBufferSize: 16
  webhookUrl: http://10.241.3.201:4318/integration/zabbix/metric/aaaaaaaa-eb71-4a8f-a0f8-05d2e79a3f32

• 工具相关命令

# 启动命令
sh one_zabbix.sh start  

# 停止命令
sh one_zabbix.sh stop 

# 重启命令
sh one_zabbix.sh restart

#  查看程序运行状态
sh one_zabbix.sh status 

# 程序启动后执行状态查看，返回如下信息则表示程序运行正常。
zabbix-realtime-export is running.

配置接入流

• ONE平台提供开箱即用的默认数据处理流。
• 也可以根据所需监控场景的需要，手动配置数据流。

验证

• 在 观测洞察 -> 数据模型 -> 指标 下查看注册的指标模型数据。
• 在 观测洞察 -> 数据探索 下查看接入的指标实时数据。