Custom checks for Zabbix monitoring system
Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
attributes
recipes
templates/default
README.md
metadata.rb

README.md

zabbix-custom-checks

Description

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

Usage

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!)

Requirements

Chef

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

Platform

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.

Cookbooks

These cookbooks are defined as external dependencies:

All of them are available through the Opscode community site.

Recipes

default

Does nothing currently...

apache2

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.

apt-update-check

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.

chef-client

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.

nginx

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

nginx

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 zabbixtemplates.com.

openvz-virtual

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

redis

Monitors redis through the output of redis-cli info.

Credits for the check script go to rdvn.

varnish

Monitors varnish through the output of varnishstat.

Credits for the check script go to rdvn.

Attributes

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

License and Author

Author:: Steffen Gebert (steffen.gebert@typo3.org)

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

http://www.apache.org/licenses/LICENSE-2.0

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.