If you like or use this project, please provide feedback to author - Star it ★.
Start one container and monitor all Docker containers on your hosts. Zabbix Docker monitoring is used - all docker module container metrics are available except docker.xnet
. Custom template Zabbix Agent XXL is provided as well. Quick start:
docker run \
--name=zabbix-agent-xxl \
-h `hostname` \
-p 10050:10050 \
-v /:/rootfs \
-e "ZA_Server=<ZABBIX SERVER IP/DNS NAME>" \
-d monitoringartist/zabbix-agent-xxl-limited:latest
Ubuntu users need also -v /var/run:/var/run
.
Tested on CoreOS, RHEL, CentOS, Ubuntu, Debian, Boot2docker, Photon OS.
Please donate to author, so he can continue to publish other awesome projects for free:
Subcribe for Zabbix Agent XXL 3.0 updates right now.
We would like to publish full version as a Docker image monitoringartist/zabbix-agent-xxl
soon. It won't have limitations of public limited image and some additional features will be added as well. Current roadmap:
- host metrics - see example of Zabbix Agent XXL template with some host metrics
- realtime docker.discovery
- Kubernetes monitoring - again realtime container discovery
- stress testing support
- tiny image size (~20MB)
It'll be supported commercially. It's available only for private beta testing at the moment.
No classic rpm/deb package installation or Zabbix module compilation. Just start zabbix-agent-xxl container and your Docker container metrics will be collected from the Docker or cgroup layer.
You can use any agent config variable, just add prefix ZA_
.
If you don't specify custom settings, then default Zabbix agent settings will be used.
Example:
docker run \
--name=zabbix-agent-xxl \
-h `hostname` \
-p 10050:10050 \
-v /:/rootfs \
-e "ZA_Server=<ZABBIX SERVER IP/DNS NAME>" \
-e "ZA_ServerActive=<ZABBIX SERVER IP/DNS NAME>" \
-e "ZA_StartAgents=10" \
-e "ZA_Timeout=30" \
-d monitoringartist/zabbix-agent-xxl-limited:latest
Some settings are excluded and you can't override them: AllowRoot, LoadModulePath, LoadModule, LogType
, because Docker monitoring module is used.
Be aware of limited monitoringartist/zabbix-agent-xxl-limited functionalities:
- zabbix agent provides only docker metrics, TLS and agent's Zabbix server IP check are disabled
- zabbix-agent-xxl-limited container publish statistic information
Source code of limited zabbix-agent is published in src directory.
- Puppet for dockerized zabbix-agent-xxl-limited
- Ansible for dockerized zabbix-agent-xxl-limited
- docker-compose for dockerized zabbix-agent-xxl-limited
Troubleshooting: check container logs docker logs zabbix-agent-xxl
. Development is driven by customer. You can still report bugs, however customer bugs/feature requests will be prioritized.
Devops Monitoring zExpert, who loves monitoring systems, which start with letter Z. Those are Zabbix and Zenoss.
Professional monitoring services: