http://coshsh.org is a framework which helps you producing configuration files for open source monitoring systems.
coshsh is very fast. (~60000 services in 10 seconds) coshsh can be extended easily. coshsh reads only hosts and applications. Services are added later.
-
Professional support and consulting is available via www.consol.de
The changelog is available on github.
coshsh reads one or many datasources (which can be files, databases, ldap…) and transforms their contents into host/service/contact-configuration files. Host- and service-definitions are created by filling placeholders in template-files.
In the beginning there are hosts and applications. There are no host and service definitions. Why? Because your server admins don’t care about. Your windows admin simply wants to enter his new machine in a cmdb. He has no time to configure check_periods or commands or services. He even doesn’t want to know what it is. The only thing he knows is name, address and model of his new server and the applications he installed.
For example, your datasource is a database table with a column names "type". If you want to handle a value of "windows" or "windows 2008" all you need is a class file for it:
from application import Application
from templaterule import TemplateRule
from util import compare_attr
def __mi_ident__(params={}):
if compare_attr("type", params, ".*windows.*"):
return Windows
class Windows(Application):
template_rules = [
TemplateRule(needsattr=None,
template="os_windows_default"),
TemplateRule(needsattr="filesystems",
template="os_windows_fs"),
]The class file will be automatically registered to coshsh. Now whenever a record of type "windows" comes out of your datasource, an object of class Windows is created. (Inside coshsh. You actually won’t notice it and you don’t have to know about it) The only thing you need to know is the relationship between an application’s class and some template files. Like this one here:
{{ application|service("os_windows_default_check_nsclient") }}
host_name {{ application.host_name }}
use os_windows_default
check_command check_nrpe_arg!60!checkUpTime!MinWarn=5m MinCrit=1m
}
{{ application|service("os_windows_default_check_cpu") }}
host_name {{ application.host_name }}
use os_windows_default,srv-pnp
max_check_attempts 10
check_command check_nrpe_arg!60!checkCPU!warn=80 crit=90 time=5m time=1m time=30s
}
{{ application|service("os_windows_default_check_mem") }}
host_name {{ application.host_name }}
use os_windows_default,srv-pnp
check_command check_nrpe_arg!60!checkMem!MaxWarn=80% MaxCrit=90% ShowAll=long type=physical type=virtual type=paged
}
{{ application|service("os_windows_default_check_autosvc") }}
host_name {{ application.host_name }}
use os_windows_default
check_command check_nrpe_arg!60!CheckServiceState!CheckAll
}
{#
{{ application|service("os_windows_default_check_ntp") }}
host_name {{ application.host_name }}
use os_windows_default
check_command windows-check_time!3600!360000
}
#}
define servicedependency {
name dependency_os_windows_default_check_nsclient_uc_{{ application.host_name }}
host_name {{ application.host_name }}
service_description os_windows_default_check_nsclient
execution_failure_criteria u,c
notification_failure_criteria u,c
dependent_service_description os_windows_.*,\
!os_windows_default_check_nsclient
}Only a nagios admin will ever see these template files and will have to edit them.