rzrbld/ze3000

zabbix-exporter-3000

zabbix-exporter-3000是一款用于将Zabbix数据转换为Prometheus可识别指标的导出工具，通过调用Zabbix API获取数据，并按照配置规则生成符合Prometheus规范的指标，便于监控数据的统一采集与分析。

!Docker hub stats !GitHub License

核心功能

1. 通过Zabbix API查询数据并转换为Prometheus指标
2. 支持自定义指标命名空间、子系统及前缀
3. 可配置指标标签，支持Zabbix响应中的多级字段映射（通过>运算符）
4. 提供Kubernetes就绪探针（/ready）和存活探针（/live）端点
5. 支持跳过Zabbix API端点的SSL验证

使用场景

• 需要将Zabbix监控数据接入Prometheus生态系统的场景
• 对Zabbix指标进行自定义加工后展示在Prometheus或Grafana中的场景
• Kubernetes环境下监控Zabbix数据的场景

配置说明

Docker部署示例

通过Docker运行该镜像的示例如下（需替换环境变量为实际值）：

bash
docker run -d \
      -p 8080:8080 \
      -e ZABBIX_API_ENDPOINT=https://zabbix.example.com/zabbix/api_jsonrpc.php \
      -e ZABBIX_USER=someuser \
      -e ZABBIX_PASSWORD=str0nGpA5sw0rd \
      -e ZABBIX_SKIP_SSL=true \
      -e ZE3000_STRICT_METRIC_REG=true \
      -e ZE3000_METRIC_NAME_FIELD="key_" \
      -e ZE3000_SINGLE_METRIC=false \
      -e ZE3000_METRIC_NAMESPACE="megacompany" \
      -e ZE3000_METRIC_SUBSYSTEM="frontend" \
      -e ZE3000_METRIC_NAME_PREFIX="nginx" \
      -e ZE3000_METRIC_VALUE="lastvalue" \
      -e ZE3000_METRIC_HELP="description" \
      -e ZE3000_METRIC_URI_PATH="/my-metrics" \
      -e ZE3000_ZABBIX_REFRESH_DELAY_SEC=20 \
      -e ZE3000_ZABBIX_METRIC_LABELS="itemid,key_,hosts>host,hosts>name,interfaces>ip,interface>dns" \
      -e ZE3000_HOST_PORT=localhost:8080 \
      -e ZE3000_ZABBIX_QUERY='{     "jsonrpc": "2.0",     "method": "item.get",     "params": {     	"application":"My Super Application",         "output": ["itemid","key_","description","lastvalue"],         "selectDependencies": "extend",         "selectHosts": ["name","status","host"],         "selectInterfaces": ["ip","dns"],         "sortfield":"key_"     },     "auth": "%auth-token%",     "id": 1 }' \
      rzrbld/ze3000:latest

可用端点

• /metrics：默认的指标采集端点（可通过ZE3000_METRIC_URI_PATH修改）
• /ready：Kubernetes就绪探针端点
• /live：Kubernetes存活探针端点

例如，访问自定义指标端点：

bash
curl http://localhost:8080/my-metrics

会返回类似以下的Prometheus指标：

megacompany_frontend_nginx_concurrencyconnections{hosts_host="mighty.fronend",hosts_name="Mighty Frontend",interface_dns="NA",interfaces_ip="10.4.4.3",itemid="452345",key_="concurrencyConnections"} 9
megacompany_frontend_nginx_numbeofconnections{hosts_host="mega.application",hosts_name="Mega Application",interface_dns="NA",interfaces_ip="NA",itemid="902934",key_="numbeOfConnections"} ***