Skip to content
Flexible and scalable monitoring framework
Python Shell Groff Ruby PHP Makefile Other
Latest commit 4bb2244 Jun 19, 2016 @hvad hvad committed on GitHub Merge pull request #1847 from NicolasLM/improve_systemd_units
Improve systemd units reliability
Failed to load latest commit information.
bin Add support of proxy socks5 for shinken cli (#1583) Apr 30, 2016
cli Add support of proxy socks5 for shinken cli (#1583) Apr 30, 2016
contrib Fix connexion spelling to connection Mar 4, 2015
doc Fixing port numbers in documentation (#1843) Apr 30, 2016
etc Reverse dependency admin <-> admins. Mar 17, 2016
external_commands Clean-up shell-scripts. Jul 16, 2012
for_fedora Improve systemd units reliability May 5, 2016
inventory Renamed to .gitkeep Nov 25, 2014
libexec Encode attachment. (#1817) Apr 30, 2016
manpages Typo: Update some doc files. (#1821) Apr 30, 2016
modules Fix: missing test case for regression imported_from in the arbiter fo… Apr 30, 2015
share Fix: get back the share directory so pack and modules can be installe… Dec 17, 2014
shinken Iterate correctly in the Services object (#1842) Apr 30, 2016
solaris/smf add solaris SMF manifests May 28, 2015
test Merge pull request #1783 from olivierHa/livestatus_item_loss Mar 9, 2016
var Renamed to .gitkeep Nov 26, 2014
.gitignore Added some more git ignored patterns Aug 28, 2015
.pylintrc Enh: Pylintrc no report Jan 26, 2015
.travis.yml Allow Shinken to run on new infra Dec 4, 2015
CONTRIBUTING.rst Enh : Add CONTRIBUTING file for PR Jul 18, 2014
COPYING Change licence to AGPLv3. This must not so be important, but I don't … Jul 15, 2009
Changelog TAG: go 2.4.3. Thanks to Olivier for his hard work on this stabilizat… Mar 10, 2016
FOR_PACKAGERS fix FOR_PACKAGERS May 31, 2015
Governance.md Add: Governance to the project Feb 11, 2015
MANIFEST.in Fix missing modules folder in the pip installation Apr 17, 2014
README Rename README to README.rst and add a README symlink Apr 11, 2011
README.rst Fix: missing badges in README May 29, 2015
THANKS Add: Alexandre Viau to the THANKS file Jun 27, 2014
clean.sh Add: move ini files into a etc/daemons directory. Jul 11, 2013
requirements.txt html dep Jul 20, 2015
setup.cfg Fix: get back the old setup.py until we fix new one for debian directly. Apr 13, 2015
setup.py TAG: go 2.4.3. Thanks to Olivier for his hard work on this stabilizat… Mar 10, 2016

README.rst

Presentation of the Shinken project

Welcome to the Shinken project.

https://api.travis-ci.org/naparuba/shinken.svg?branch=master

Shinken is a modern, Nagios compatible monitoring framework, written in Python. Its main goal is to give users a flexible architecture for their monitoring system that is designed to scale to large environments.

Shinken is backwards-compatible with the Nagios configuration standard and plugins. It works on any operating system and architecture that supports Python, which includes Windows, GNU/Linux and FreeBSD.

Requirements

See the Documentation

There are mandatory and conditional requirements for the installation methods which are described below.

Installing Shinken

See the Documentation

Update

Launch:

python setup.py install --update

It will only update the shinken lib and scripts, but won't touch your current configuration

Running

Shinken is installed with init.d scripts, enables them at boot time and starts them right after the install process ends. Based on your linux distro you only need to do:

chkconfig --add shinken chkconfig shinken on

or :

update-rc.d shinken defaults 20

Where is the configuration?

The configuration is on the directory, /etc/shinken.

Where are the logs?

Logs are in /var/log/shinken (what did you expect?)

I got a bug, how to launch the daemons in debug mode?

You only need to launch:

/etc/init.d/shinken -d start

Debug logs will be based on the log directory (/var/log/shinken)

I switched from Nagios, do I need to change my existing Nagios configuration?

No, there is no need to change the existing configuration - unless you want to add some new hosts and services. Once you are comfortable with Shinken you can start to use its unique and powerful features.

Learn more about how to use and configure Shinken

Jump to the Shinken documentation.

If you find a bug

Bugs are tracked in the issue list on GitHub . Always search for existing issues before filing a new one (use the search field at the top of the page). When filing a new bug, please remember to include:

  • A helpful title - use descriptive keywords in the title and body so others can find your bug (avoiding duplicates).
  • Steps to reproduce the problem, with actual vs. expected results
  • Shinken version (or if you're pulling directly from the Git repo, your current commit SHA - use git rev-parse HEAD)
  • OS version
  • If the problem happens with specific code, link to test files (gist.github.com is a great place to upload code).
  • Screenshots are very helpful if you're seeing an error message or a UI display problem. (Just drag an image into the issue description field to include it).
Something went wrong with that request. Please try again.