benyoo/zabbix

Dockbix XXL

https://github.com/monitoringartist/dockbix-xxl 是一个Docker化的Zabbix，预配置用于便捷的Docker监控。此Docker镜像包含标准Zabbix以及额外的XXL社区扩展。包含常规任务：Zabbix数据库自动导入、Docker监控模板自动导入、https://github.com/monitoringartist/dockbix-agent-xxl%E7%9A%84%E8%87%AA%E5%8A%A8%E6%B3%A8%E5%86%8C%E8%A7%84%E5%88%99%E7%AD%89%E3%80%82

如果您喜欢或使用此项目，请向作者提供反馈 - 为其点赞 ★ 或为上游项目点赞 ★。

免费测试Dockbix实例

免费测试Dockbix，仅需免费的Docker ID，即可免费启动完整的容器化Dockbix XXL，持续4小时。您也可以测试最新开发版本（从trunk svn分支编译）：

!https://raw.githubusercontent.com/monitoringartist/dockbix-xxl/master/doc/dockbix-docker-playground.gif

---

Monitoring Artist（容器化）监控生态系统概述：

• https://hub.docker.com/r/monitoringartist/dockbix-xxl/ - Zabbix服务器/代理/UI/snmpd/Java网关，带有额外扩展
• https://hub.docker.com/r/monitoringartist/dockbix-agent-xxl-limited/ - 带有https://github.com/monitoringartist/zabbix-docker-monitoring%E6%A8%A1%E5%9D%97%E7%9A%84Zabbix%E4%BB%A3%E7%90%86
• https://hub.docker.com/r/monitoringartist/zabbix-templates/ - 小型Docker镜像，用于所选Zabbix监控模板的简单部署
• https://hub.docker.com/r/monitoringartist/zabbix-ext-all-templates/ - Dockbix XXL的存储镜像，包含200+https://github.com/zabbix/zabbix-community-repos
• https://github.com/monitoringartist/kubernetes-zabbix - 基于Kubernetes的容器化Zabbix集群
• https://hub.docker.com/r/monitoringartist/grafana-xxl/ - 带有所有社区插件的Docker化Grafana
• Grafana dashboards - 用于https://github.com/monitoringartist/grafana-aws-cloudwatch-dashboards%E5%92%8Chttps://github.com/monitoringartist/grafana-zabbix-dashboards%E7%9A%84Grafana%E4%BB%AA%E8%A1%A8%E6%9D%BF%E9%9B%86%E5%90%88
• https://hub.docker.com/r/monitoringartist/monitoring-analytics/ - 数据科学家为Zabbix数据开发的图形分析工具
• https://hub.docker.com/r/***/ - 用于Docker压力测试和Docker编排测试的Docker镜像

---

编译的Zabbix（服务器、代理、代理、Java网关、snmpd守护进程）几乎包含所有功能（MySQL支持、Java、SNMP、Curl、Ipmi、SSH、fping），以及基于CentOS 7、Supervisor、Nginx、PHP 7的Zabbix Web UI。镜像需要外部MySQL/MariaDB数据库（您可以将MySQL/MariaDB作为Docker容器运行）。集成的XXL扩展：Searcher、Grapher、Zapix、模板自动导入、API命令/脚本执行（部分扩展必须显式启用 - 参见环境变量部分）。

!https://raw.githubusercontent.com/monitoringartist/dockbix-xxl/master/doc/dockbix-xxl-zabbix-searcher.png !https://raw.githubusercontent.com/monitoringartist/dockbix-xxl/master/doc/dockbix-xxl-zapix.png !https://raw.githubusercontent.com/monitoringartist/dockbix-xxl/master/doc/dockbix-xxl-grapher.png

快速开始

sh
# 创建在/var/lib/mysql文件夹中具有持久存储的数据容器
docker run -d -v /var/lib/mysql --name dockbix-db-storage busybox:latest

# 启动Dockbix的数据库 - 使用默认的1GB innodb_buffer_pool_size
docker run \
    -d \
    --name dockbix-db \
    -v /backups:/backups \
    -v /etc/localtime:/etc/localtime:ro \
    --volumes-from dockbix-db-storage \
    --env="MARIADB_USER=zabbix" \
    --env="MARIADB_PASS=my_password" \
    monitoringartist/zabbix-db-mariadb

# 启动链接到已启动数据库的Dockbix
docker run \
    -d \
    --name dockbix \
    -p 80:80 \
    -p 10051:10051 \
    -v /etc/localtime:/etc/localtime:ro \
    --link dockbix-db:dockbix.db \
    --env="ZS_DBHost=dockbix.db" \
    --env="ZS_DBUser=zabbix" \
    --env="ZS_DBPassword=my_password" \
    --env="XXL_zapix=true" \
    --env="XXL_grapher=true" \
    monitoringartist/dockbix-xxl:latest
# 等待约30秒进行Zabbix初始化
# Zabbix Web将在80端口可用，Zabbix服务器在10051端口可用
# 默认凭据：Admin/zabbix

管理任务示例

sh
## Zabbix数据库备份 - 仅配置数据，无项目历史/趋势
docker exec \
    -ti dockbix-db \
    /zabbix-backup/zabbix-mariadb-dump -u zabbix -p my_password -o /backups

## Zabbix数据库完整压缩备份
docker exec \
    -ti dockbix-db \
    bash -c "\
    mysqldump -u zabbix -pmy_password zabbix | \
    bzip2 -cq9 > /backups/zabbix_db_dump_$(date +%Y-%m-%d-%H.%M.%S).sql.bz2"

## 数据库数据恢复
# 删除Dockbix容器
docker rm -f dockbix
# 从备份恢复数据库数据（当前所有数据将被删除！！！）
docker exec -i dockbix-db sh -c 'bunzip2 -dc /backups/zabbix_db_dump_2017-28-09-02.57.46.sql.bz2 | mysql -uzabbix -p --password=my_password zabbix'
# 再次运行Dockbix容器
docker run ...

### 启动带有Java网关和Java轮询器的Dockbix
docker run \
    -d \
    --name dockbix \
    -p 80:80 \
    -p 10051:10051 \
    -v /etc/localtime:/etc/localtime:ro \
    --link dockbix-db:dockbix.db \
    --env="ZS_DBHost=dockbix.db" \
    --env="ZS_DBUser=zabbix" \
    --env="ZS_DBPassword=my_password" \
    --env="XXL_zapix=true" \
    --env="XXL_grapher=true" \
    --env="ZJ_enabled=true" \
    --env="ZS_StartJavaPollers=3" \
    monitoringartist/dockbix-xxl:latest

## HTTPS；更复杂的设置覆盖/etc/nginx/hosts.d/ssl-nginx.conf
docker run \
    -d \
    --name dockbix \
    -p 443:443 \
    -p 10051:10051 \
    -v /etc/localtime:/etc/localtime:ro \
    -v /<SSL证书路径>/<证书文件>:/etc/nginx/ssl/dummy.crt:ro \
    -v /<SSL密钥路径>/<密钥文件>:/etc/nginx/ssl/dummy.key:ro \
    --link dockbix-db:dockbix.db \
    --env="ZS_DBHost=dockbix.db" \
    --env="ZS_DBUser=zabbix" \
    --env="ZS_DBPassword=my_password" \
    --env="XXL_zapix=true" \
    --env="XXL_grapher=true" \
    monitoringartist/dockbix-xxl:latest

使用Docker Compose启动

docker-compose up -d

作为Docker容器的Dockbix/Zabbix数据库

要能够连接到数据库，我们首先需要运行一个数据库。最简单的方法是使用另一个Docker镜像。为此，您可以使用https://registry.hub.docker.com/u/monitoringartist/zabbix-db-mariadb%E9%95%9C%E5%83%8F%E4%BD%9C%E4%B8%BA%E6%95%B0%E6%8D%AE%E5%BA%93%E3%80%82

有关monitoringartist/zabbix-db-mariadb的更多信息，请参见https://github.com/monitoringartist/dockbix-xxl/tree/master/Dockerfile/zabbix-db-mariadb%E3%80%82

示例：

docker run \
	-d \
	--name dockbix-db \
	-p 3306:3306 \
	-v /etc/localtime:/etc/localtime:ro \
	--env="MARIADB_USER=zabbix" \
	--env="MARIADB_PASS=my_password" \
	monitoringartist/zabbix-db-mariadb

部署Dockbix镜像时请使用相同的数据库凭据。

环境变量

与XXL特性相关的可用变量：

使用环境变量配置Zabbix服务器和Zabbix Web UI（PHP）。您可以添加任何Zabbix配置变量，只需添加正确的变量前缀（ZS_用于Zabbix Server，ZP_用于Zabbix Proxy）并设置变量值。对多个配置参数使用数字后缀（_<NUM>）。示例：您需要增加CacheSize并为Zabbix服务器加载两个模块：

ZS_CacheSize=50M
ZS_LoadModule_1=module1.so
ZS_LoadModule_2=module2.so

如果您未指定环境变量配置且变量未在默认容器变量中列出，则使用默认Zabbix配置值。默认容器变量：

注意：日本用户可能需要设置环境变量ZBX_GRAPH_FONT_NAME=ipagp以支持图形中的日文字体。

来自卷的配置

也可以使用Zabbix配置文件。在这种情况下，环境配置将被配置文件中的值覆盖。您只需添加/etc/custom-config/卷：

-v /host/custom-config/:/etc/custom-config/

可用的配置文件名：

Zabbix角色环境变量：

默认情况下，除SNMP陷阱处理外，所有Zabbix服务器组件均已启用。但是，有些用户希望每个容器运行专用的Zabbix组件。典型用例是Zabbix Web UI。借助角色环境变量，用户能够执行多个Web UI容器，这有助于将Zabbix扩展为服务。

XXL API特性

如果环境变量XXL_api为true（默认值），则引导脚本将尝试在/etc/zabbix/api中递归查找任何.xml、.api、.sh文件。例如，挂载包含XML模板的文件夹，脚本将尝试导入所有模板：

sh
-v /myhosttemplatefolder/:/etc/zabbix/api/mytemplates

• XML文件：所有*.xml文件被处理为Zabbix XML模板，脚本尝试使用Zabbix API导入它们。默认额外导入的模板是https://github.com/monitoringartist/zabbix-docker-monitoring/tree/master/template%E3%80%82

• Api文件：所有*.api文件被