Skip to main content

Shinken is a monitoring framework compatible with Nagios configuration and plugins

Project description

Welcome to the Shinken project.

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 and GNU/Linux.

Requirements

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

Mandatory Requirements

shinken requires

  • Python 2.6 or higher (2.7 will get higher performances)

  • python-pycurl Python package for Shinken daemon communications

  • setuptools or distribute Python package for installation

Conditional Requirements

  • Python 2.7 is required for developers to run the test suite, shinken/test/

  • python-cherrypy3 (recommanded) enhanceddaemons communications, especially in HTTPS mode

Installing/Checking Common Requirements on Windows

There is an installation guide for Windows and an installation package.

Installing on Linux

How to install Shinken

You will need a specific user for running shinken :

useradd –user-group shinken

You simply need to launch:

python setup.py install

Update

Launch:

python setup.py 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 wiki.

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Shinken-2.0.tar.gz (26.5 MB view details)

Uploaded Source

File details

Details for the file Shinken-2.0.tar.gz.

File metadata

  • Download URL: Shinken-2.0.tar.gz
  • Upload date:
  • Size: 26.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for Shinken-2.0.tar.gz
Algorithm Hash digest
SHA256 ec86e84284d922ae1121e673b3f490d362b6292132d541e3f5a5791914bce7e1
MD5 9f36c39f47008e0047f4a3902f536819
BLAKE2b-256 e94c7ec2c565c849a13e59dc6c691835541f2f268e47a87761c5b38f70df180f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page