Shinken (software)

Shinken
Shinken screenshot
Original author	Jean Gabès
Initial release	December 1, 2009 (2009-12-01)
Stable release	2.4.3 / March 10, 2016 (2016-03-10)
Repository	github.com/naparuba/shinken
Written in	Python
Operating system	Unix-like, Windows
Type	Network monitoring
License	Affero General Public License
Website	Archived 15 December 2023 at the Wayback Machine

Shinken is an open source computer system and network monitoring software application compatible with Nagios. It watches hosts and services, gathers performance data and alerts users when error conditions occur and again when the conditions clear.

Shinken's architecture aims to offer easier load balancing and high availability. The administrator manages a single configuration, the system automatically "cuts" it into parts and dispatches it to worker nodes. It takes its name from this functionality: a Shinken is a Japanese sword.

Shinken was written by Jean Gabès as a proof of concept for a new Nagios architecture. Believing the new implementation was faster and more flexible than the old C code, he proposed it as the new development branch of Nagios 4. This proposal was turned down by the Nagios authors, so Shinken became an independent network monitoring software application compatible with Nagios.

Shinken is designed to run under all operating systems where Python runs. The development environment is under Linux, but also runs well on other Unix variants and Windows. The reactionner process (responsible for sending notifications) can also be run under the Android OS. It is free software, licensed under the terms of the Affero General Public License as published by the Free Software Foundation.

Overview

• Design
  • Monitoring system written in Python
  • Distributed architecture using Pyro remote objects
• Active and Passive monitoring methods
  • Monitoring of network services (SMTP, POP3, HTTP, NNTP, ICMP, SNMP, FTP, SSH)
  • Monitoring of host resources (processor load, disk usage, system logs) on a majority of network operating systems, including Microsoft Windows
    • Using agents such as NSClient++, send_nsca, Check MK, Thrift TSCA
    • Using agents permitting remotely run scripts via Nagios Remote Plugin Executor (An embedded pure-Python implementation is included with Shinken)
    • Using agent-less methods such as SNMP, WMI, scripted SSH or HTTP(SSL)
    • Send check results directly from programs using Apache Thrift (Java, Python, Ruby)
  • Monitoring of systems which have the ability to send collected data via a network to specifically written plugins (Ex. VMWare ESX3/4/5, Collectd)
  • Remote monitoring supported through SSH or SSL encrypted tunnels.
  • Simple plugin design that allows users to easily develop their own service checks depending on needs, by using the tools of choice (shell scripts, C++, Perl, Ruby, Python, PHP, C#, etc.)
  • Ability to calculate KPIs from State and performance data in the Shinken core to create new services and performance data
• System external interfaces
  • Livestatus compatible API that exposes state, configuration and performance information
  • Exports data to graphing modules (PNP4Nagios, Graphite, and others available)
  • Support for native messaging API of Android
  • Export event data to logging systems using syslog and RabbitMQ
  • Modules can be attached to any Shinken process to extend its capabilities in very efficient ways
• Performance
  • Parallelized service and host checks available
  • Ability to distribute poller processes on multiple servers
  • Support for implementing easily redundant and load balanced monitoring hosts
  • Support for multiple redundant external interfaces
  • Ability to route checks to dedicated pollers (processes specialized in executing plugins)
• Correlation and business intelligence
  • Parent child relations
    • Ability to define network host hierarchy using "parent" hosts, allowing detection of and distinction between hosts that are down and those that are unreachable
    • 1 to 1, 1 to N
  • Free form dependency trees between any service and host
    • 1 to 1, 1 to N
  • Support for integrated business rules
    • Calculated hosts or services representing the state of a business service
    • Support assigning a business impact to each service, host or business process
  • Ability to show only root problems
  • Automatically changes child states to unknown when parent is unavailable
• Other features
  • Contact notifications when service or host problems occur and get resolved (via e-mail, pager, SMS, or any user-defined method through plugin system)
  • Ability to define event handlers to be run during service or host events for proactive problem resolution
  • Ability to redefine the severity of an alert based on regular expression rules
  • Support for UTF-8 objects names
  • Support for monitoring multiple customers with one administration point
  • Support for recurring downtimes through the maintenance_period attribute
  • Advanced template system with inheritance and overloading

Development

Shinken has an open and test-driven development approach, with contributors to the project providing new features, code refactoring, code quality and bug fixing.

The source code is hosted on GitHub. An integration server runs tests at each commit and in depth tests at regular intervals.

The Shinken documentation is hosted on a wiki.

See also

• Comparison of network monitoring systems
• NRPE
• Icinga
• Nagios
• Collectd

External links

• Official website
• Monitoring Plugins the home of the official plugins
• (in German) Linux Magazin article about Shinken in the German Linux Magazin 04/2010