Skip to content

Adam-Gold/zabbix-agent-xxl

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Zabbix Agent 3.0 XXL with Docker monitoring

Deploy to Docker Cloud

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:

Paypal donate button

Zabbix Agent 3.0 XXL without any limitations

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.

How it works

Zabbix Agent XXL Docker container

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.

Environment configuration variables

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.

Limitations

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.

Integrations

Troubleshooting and bugs

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.

Author

Devops Monitoring zExpert, who loves monitoring systems, which start with letter Z. Those are Zabbix and Zenoss.

Professional monitoring services:

Monitoring Artist

About

Dockerized Zabbix agent 3.0 with Docker monitoring for CoreOS, RHEL, CentOS, Ubuntu, Debian, Boot2docker, ...

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • PHP 50.2%
  • C 39.9%
  • HTML 2.8%
  • JavaScript 2.5%
  • CSS 2.1%
  • SQLPL 0.5%
  • Other 2.0%