Custom checks for Zabbix monitoring system
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



Collection of custom checks for the Zabbix monitoring software used in the Server Admin team of the TYPO3 project.


Include the specific recipe in the node's run list and load the according zabbix_template.xml into Zabbix. Please note: If you are not using active checks, you have to change the type of monitored objects from Zabbix agent (active) to Zabbix agent. Zabbix uses passive checks by default, which lets the Zabbix server/proxy collect the statistics.

Some recipies require sudo privileges. The recipies will put a file into /etc/sudoers.d/, thus make sure that your /etc/sudoers includes files from there. This can be achieved by including the following line in `/etc/sudoers:

#includedir /etc/sudoers.d

(note that the trailing # does not mean the line is commented out!)



Tested on 0.10.8 and 0.10.10 but newer and older version should work just fine.


The following platforms have been tested with this cookbook, meaning that the recipes and LWRPs run on these platforms without error:

  • ubuntu (10.04)
  • debian (6.0)

Please report any additional platforms so they can be added.


These cookbooks are defined as external dependencies:

All of them are available through the Opscode community site.



Does nothing currently...


Monitors Apache 2 through the output of mod_status at /server-status. Sets up an extra vHost on Port 61709 in order to not conflict with a reverse proxy (exposing the server-status to the outside world).

Credits for the check script go to rdvn.


Monitors the output of apt-check and reports, whether security or normal updates for installed apt-packages are available. Requires to run apt-get update regularly, etc. through the apt cookbook.


Monitors the duration of chef-client runs and the success status. Failed runs and continuously slow execution (>60 seconds) are reported. Makes use of chef_handler and registers as a report handler.


Monitors Nginx through the output of HttpStubStatusModule at /server_status. This means that Nginx has to be compiled with --with-http_stub_status_module.


Monitors Nginx through the output of HttpStubStatusModule at /nginx_status. This means that Nginx has to be compiled with --with-http_stub_status_module. The port of the virtual host can be defined through node[:zabbix_custom_checks][:nginx][:port].

Credits for the check script go to


Monitors OpenVZ VEs from inside the container through the output of /proc/user_beancounter. Alerts on exceeding the limits through a beancount monitor.


Monitors redis through the output of redis-cli info.

Credits for the check script go to rdvn.


Monitors varnish through the output of varnishstat.

Credits for the check script go to rdvn.


  • node[:zabbix_custom_checks][:nginx][:port] to change the port, where /nginx_status is available.

License and Author

Author:: Steffen Gebert (

Copyright 2011, 2012, Steffen Gebert for TYPO3 Association

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.