# coshsh Config-Generator for Shinken / Nagios /Icinga
## What is coshsh?
Coshsh is a framework which helps you producing configuration files for open source monitoring systems.
## Features
* coshsh is very fast. (~60000 services in 10 seconds)
* coshsh can be extended easily.
* coshsh reads only hosts and applications. Services are added later.
## Why should you use it?
Because others use it too.
* The city of Munich. https://bit.ly/2QhNCOJ
* A car manufacturer in Munich with three letters.
* A global storage company with three letters. (they were bought and now have four letters)
* Lidl/Kaufland. https://bit.ly/2L459nH
* A chinese car manufacturer in Shenyang.
* An austrian company producing crystal products.
* A world-wide operating consulting firm.
* A venerable hanseatic bank.
and many more companies which eliminated manual tasks in monitoring.
## Download
http://labs.consol.de/nagios/coshsh
## Support
Professional support and consulting is available via [www.consol.de](http://www.consol.de/open-source-monitoring/support)
## Changelog
The changelog is available on
[github](https://github.com/lausser/coshsh/blob/master/Changelog)
## How does it work
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:
```python
import coshsh
def __mi_ident__(params={}):
if coshsh.util.compare_attr("type", params, ".*windows.*"):
return Windows
class Windows(coshsh.application.Application):
template_rules = [
coshsh.templaterule.TemplateRule(needsattr=None,
template="os_windows_default"),
coshsh.templaterule.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.
[](https://coveralls.io/github/lausser/coshsh?branch=master)
Raw data
{
"_id": null,
"home_page": "http://github.com/lausser/coshsh",
"name": "coshsh",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "nagios, icinga, naemon, shinken, prometheus, monitoring",
"author": "Gerhard Lausser",
"author_email": "gerhard.lausser@consol.de",
"download_url": "https://files.pythonhosted.org/packages/24/c9/9a78a32a1d60fb02da2bd486a786f521ca9e270a7ddd25b0eec65b4b324f/coshsh-10.2.3.tar.gz",
"platform": null,
"description": "# coshsh Config-Generator for Shinken / Nagios /Icinga\n\n## What is coshsh?\n\nCoshsh is a framework which helps you producing configuration files for open source monitoring systems.\n\n## Features\n\n* coshsh is very fast. (~60000 services in 10 seconds)\n* coshsh can be extended easily.\n* coshsh reads only hosts and applications. Services are added later.\n\n## Why should you use it?\nBecause others use it too.\n* The city of Munich. https://bit.ly/2QhNCOJ\n* A car manufacturer in Munich with three letters. \n* A global storage company with three letters. (they were bought and now have four letters)\n* Lidl/Kaufland. https://bit.ly/2L459nH\n* A chinese car manufacturer in Shenyang.\n* An austrian company producing crystal products.\n* A world-wide operating consulting firm.\n* A venerable hanseatic bank.\n\nand many more companies which eliminated manual tasks in monitoring.\n\n## Download\n\nhttp://labs.consol.de/nagios/coshsh\n\n## Support\n\nProfessional support and consulting is available via [www.consol.de](http://www.consol.de/open-source-monitoring/support)\n\n## Changelog\n\nThe changelog is available on\n[github](https://github.com/lausser/coshsh/blob/master/Changelog)\n\n## How does it work\n\ncoshsh 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.\n\n\nIn 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. \nThe only thing he knows is name, address and model of his new server and the applications he installed. \n\nFor 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:\n\n```python\nimport coshsh\n\ndef __mi_ident__(params={}):\n if coshsh.util.compare_attr(\"type\", params, \".*windows.*\"):\n return Windows\n\n\nclass Windows(coshsh.application.Application):\n template_rules = [\n coshsh.templaterule.TemplateRule(needsattr=None,\n template=\"os_windows_default\"),\n coshsh.templaterule.TemplateRule(needsattr=\"filesystems\",\n template=\"os_windows_fs\"),\n ]\n```\n\nThe 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)\nThe only thing you need to know is the relationship between an application's class and some template files. Like this one here:\n\n```\n{{ application|service(\"os_windows_default_check_nsclient\") }}\n host_name {{ application.host_name }}\n use os_windows_default\n check_command check_nrpe_arg!60!checkUpTime!MinWarn=5m MinCrit=1m\n}\n\n{{ application|service(\"os_windows_default_check_cpu\") }}\n host_name {{ application.host_name }}\n use os_windows_default,srv-pnp\n max_check_attempts 10\n check_command check_nrpe_arg!60!checkCPU!warn=80 crit=90 time=5m time=1m time=30s\n}\n\n{{ application|service(\"os_windows_default_check_mem\") }}\n host_name {{ application.host_name }}\n use os_windows_default,srv-pnp\n check_command check_nrpe_arg!60!checkMem!MaxWarn=80% MaxCrit=90% ShowAll=long type=physical type=virtual type=paged\n}\n\n{{ application|service(\"os_windows_default_check_autosvc\") }}\n host_name {{ application.host_name }}\n use os_windows_default\n check_command check_nrpe_arg!60!CheckServiceState!CheckAll\n}\n\n{#\n{{ application|service(\"os_windows_default_check_ntp\") }}\n host_name {{ application.host_name }}\n use os_windows_default\n check_command windows-check_time!3600!360000\n}\n#}\n\ndefine servicedependency {\n name dependency_os_windows_default_check_nsclient_uc_{{ application.host_name }}\n host_name {{ application.host_name }}\n service_description os_windows_default_check_nsclient\n execution_failure_criteria u,c\n notification_failure_criteria u,c\n dependent_service_description os_windows_.*,\\\n !os_windows_default_check_nsclient\n}\n```\n\nOnly a nagios admin will ever see these template files and will have to edit them.\n\n[](https://coveralls.io/github/lausser/coshsh?branch=master)\n",
"bugtrack_url": null,
"license": "AGPLv3",
"summary": "Coshsh - config generator for monitoring systems",
"version": "10.2.3",
"project_urls": {
"Homepage": "http://github.com/lausser/coshsh"
},
"split_keywords": [
"nagios",
" icinga",
" naemon",
" shinken",
" prometheus",
" monitoring"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b107ee8810d943e3cb9427a58374de34ad1b43e316bf8226e5a3030c2d9bc745",
"md5": "1b1c8377e5ebd35be61b31c9c71ae46b",
"sha256": "2a8f4c47bb01afa8e5052616467bd8cb39e55df951788e4ea67d5474eb7d44b4"
},
"downloads": -1,
"filename": "coshsh-10.2.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1b1c8377e5ebd35be61b31c9c71ae46b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 75160,
"upload_time": "2024-10-25T19:56:15",
"upload_time_iso_8601": "2024-10-25T19:56:15.823064Z",
"url": "https://files.pythonhosted.org/packages/b1/07/ee8810d943e3cb9427a58374de34ad1b43e316bf8226e5a3030c2d9bc745/coshsh-10.2.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "24c99a78a32a1d60fb02da2bd486a786f521ca9e270a7ddd25b0eec65b4b324f",
"md5": "f3972671f14f967af4770d0b2c7650e6",
"sha256": "77713691e379883bc8e4db7f4193066e1a706b8c1c8eb112332e67c6d30ff036"
},
"downloads": -1,
"filename": "coshsh-10.2.3.tar.gz",
"has_sig": false,
"md5_digest": "f3972671f14f967af4770d0b2c7650e6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 18079139,
"upload_time": "2024-10-25T19:56:18",
"upload_time_iso_8601": "2024-10-25T19:56:18.322567Z",
"url": "https://files.pythonhosted.org/packages/24/c9/9a78a32a1d60fb02da2bd486a786f521ca9e270a7ddd25b0eec65b4b324f/coshsh-10.2.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-25 19:56:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "lausser",
"github_project": "coshsh",
"travis_ci": true,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "coshsh"
}
JSON
