Shinken Manual
About
About Shinken
Feature comparison between Shinken and Nagios
Shinken notable innovations
The project Vision
Feature selection and release cycle
Release code names
Getting Started
Advice for Beginners
Quickstart Installation Guides
Installations
Upgrading Shinken
Monitoring Windows Machines
Monitoring GNU/Linux & Unix Machines
Monitoring Network Printers
Monitoring Routers and Switches
Monitoring Publicly Available Services
Nagios/Shinken Plugins
Introduction
What Are Plugins?
Shinken integrated data acquisition modules
Plugins As An Abstraction Layer
What Plugins Are Available?
Obtaining Plugins
How Do I Use Plugin X?
Plugin API
Configuring Shinken
Configuration Overview
Main Configuration File Options
Object Configuration Overview
Object Definitions
Custom Object Variables
Main advanced configuration
Running Shinken
Verifying Your Configuration
Starting and Stopping Shinken
The Basics
Setting up a basic Shinken Configuration
Nagios/Shinken Plugins
Understanding Macros and How They Work
Standard Macros in Shinken
Host Checks
Service Checks
Active Checks
Passive Checks
State Types
Time Periods
Determining Status and Reachability of Network Hosts
Notifications
Active data acquisition modules
Network dependencies
Logical dependencies
Update Shinken
Medium
Business rules
Monitoring a DMZ
Shinken High Availability
Mixed GNU/linux AND Windows pollers
Notifications and escalations
The Notification Ways, AKA mail 24x7, SMS only the night for a same contact
Passive data acquisition
Advanced Topics
External Commands
Event Handlers
Volatile Services
Service and Host Freshness Checks
Distributed Monitoring
Redundant and Failover Network Monitoring
Detection and Handling of State Flapping
Notification Escalations
On-Call Rotations
Monitoring Service and Host Clusters
Host and Service Dependencies
State Stalking
Performance Data
Scheduled Downtime
Adaptive Monitoring
Predictive Dependency Checks
Cached Checks
Passive Host State Translation
Service and Host Check Scheduling
Object Inheritance
Advanced tricks
Business rules
Migrating from Nagios to Shinken
Multi layer discovery
Multiple action urls
Aggregation rule
Scaling Shinken for large deployments
Defining advanced service dependencies
Shinken’s distributed architecture
Shinken’s distributed architecture with realms
Macro modulations
Shinken and Android
Send sms by gateway
Triggers
Unused nagios parameters
Advanced discovery with Shinken
Discovery with Shinken
Config
Host Definition
Host Group Definition
Service Definition
Service Group Definition
Contact Definition
Contact Group Definition
Time Period Definition
Command Definition
Service Dependency Definition
Service Escalation Definition
Host Dependency Definition
Host Escalation Definition
Extended Host Information Definition
Extended Service Information Definition
Notification Way Definition
Realm Definition
Arbiter Definition
Scheduler Definition
Poller Definition
Reactionner Definition
Broker Definition
Shinken Architecture
Arbiter supervision of Shinken processes
Advanced architectures
How are commands and configurations managed in Shinken
Problems and impacts correlation management
Problems and impacts correlation management
Shinken Architecture
Troubleshooting
FAQ - Shinken troubleshooting
Integration With Other Software
Integration Overview
SNMP Trap Integration
TCP Wrappers Integration
Thruk
Nagios CGI UI
Thruk interface
Use Shinken with ...
Use Shinken with Centreon
Use Shinken with Graphite
Use Shinken with Multisite
Use Shinken with Nagvis
Use Shinken with Old CGI and VShell
Use Shinken with PNP4Nagios
Use Shinken with Thruk
Use Shinken with WebUI
Security and Performance Tuning
Security Considerations
Tuning Shinken For Maximum Performance
Scaling a Shinken installation
Shinken performance statistics
How to monitor ...
Monitoring an Asterisk server
check_wmi_plus.pl for shinken on windows
Monitoring Active Directory
Monitoring a DHCP server
Monitoring Microsoft Exchange
Monitoring a IIS server
Monitoring Linux Devices
Monitoring Linux Devices
Monitoring a Linux via a Local Agent
Monitoring a Linux via SNMP
Monitoring Publicly Available Services
Monitoring a printer
Monitoring Network Devices
Monitoring Windows Devices
Monitoring Microsoft Mssql server
Monitoring MySQL
Monitoring VMware Machines
Monitoring Microsoft Mssql server
Monitoring MySQL
Monitoring Publicly Available Services
Monitoring an Oracle database server
Monitoring a printer
Monitoring Network Devices
Monitoring VMware Machines
Monitoring Windows witn NSClient++
Monitoring Windows Devices
How to contribute
Shinken packs
Shinken modules and Shinken packs
Help the Shinken project
Getting Help and Ways to Contribute
Shinken Package Manager
Development
Shinken Programming Guidelines
Test Driven Development
Nagios Plugin API
Developing Shinken Daemon Modules
Hacking the Shinken Code
Shinken modules
Amazon AWS/EC2 import
Amazon AWS/EC2 import
The distributed retention modules
How to enable and use Livestatus module
Exporting data for reporting
Monitoring Linux System with Glances and checkglances.py
Shinken GLPI integration
Ip Tag module
Ubuntu Landscape import
Shinken Livestatus API
NSCA module
Retention troubleshooting
NRPE Module
Extending Shinken
Broker modules
TSCA (Thrift Service Check Acceptor)
VMWare Arbiter module
Web Service Module
SNMP module
WebUI module
Reference
shinken
shinken Package
clients Package
daemons Package
discovery Package
misc Package
objects Package
webui Package
Shinken Manual
Docs
»
Welcome to Shinken’s documentation!
Edit on GitHub
Welcome to Shinken’s documentation!
¶
Contents:
About
About Shinken
Feature comparison between Shinken and Nagios
Shinken notable innovations
The project Vision
Feature selection and release cycle
Release code names
Getting Started
Advice for Beginners
Quickstart Installation Guides
Installations
Upgrading Shinken
Monitoring Windows Machines
Monitoring GNU/Linux & Unix Machines
Monitoring Network Printers
Monitoring Routers and Switches
Monitoring Publicly Available Services
Nagios/Shinken Plugins
Introduction
What Are Plugins?
Shinken integrated data acquisition modules
Plugins As An Abstraction Layer
What Plugins Are Available?
Obtaining Plugins
How Do I Use Plugin X?
Plugin API
Configuring Shinken
Configuration Overview
Main Configuration File Options
Object Configuration Overview
Object Definitions
Custom Object Variables
Main advanced configuration
Running Shinken
Verifying Your Configuration
Starting and Stopping Shinken
The Basics
Setting up a basic Shinken Configuration
Nagios/Shinken Plugins
Understanding Macros and How They Work
Standard Macros in Shinken
Host Checks
Service Checks
Active Checks
Passive Checks
State Types
Time Periods
Determining Status and Reachability of Network Hosts
Notifications
Active data acquisition modules
Network dependencies
Logical dependencies
Update Shinken
Medium
Business rules
Monitoring a DMZ
Shinken High Availability
Mixed GNU/linux AND Windows pollers
Notifications and escalations
The Notification Ways, AKA mail 24x7, SMS only the night for a same contact
Passive data acquisition
Advanced Topics
External Commands
Event Handlers
Volatile Services
Service and Host Freshness Checks
Distributed Monitoring
Redundant and Failover Network Monitoring
Detection and Handling of State Flapping
Notification Escalations
On-Call Rotations
Monitoring Service and Host Clusters
Host and Service Dependencies
State Stalking
Performance Data
Scheduled Downtime
Adaptive Monitoring
Predictive Dependency Checks
Cached Checks
Passive Host State Translation
Service and Host Check Scheduling
Object Inheritance
Advanced tricks
Business rules
Migrating from Nagios to Shinken
Multi layer discovery
Multiple action urls
Aggregation rule
Scaling Shinken for large deployments
Defining advanced service dependencies
Shinken’s distributed architecture
Shinken’s distributed architecture with realms
Macro modulations
Shinken and Android
Send sms by gateway
Triggers
Unused nagios parameters
Advanced discovery with Shinken
Discovery with Shinken
Config
Host Definition
Host Group Definition
Service Definition
Service Group Definition
Contact Definition
Contact Group Definition
Time Period Definition
Command Definition
Service Dependency Definition
Service Escalation Definition
Host Dependency Definition
Host Escalation Definition
Extended Host Information Definition
Extended Service Information Definition
Notification Way Definition
Realm Definition
Arbiter Definition
Scheduler Definition
Poller Definition
Reactionner Definition
Broker Definition
Shinken Architecture
Arbiter supervision of Shinken processes
Advanced architectures
How are commands and configurations managed in Shinken
Problems and impacts correlation management
Problems and impacts correlation management
Shinken Architecture
Troubleshooting
FAQ - Shinken troubleshooting
Integration With Other Software
Integration Overview
SNMP Trap Integration
TCP Wrappers Integration
Thruk
Nagios CGI UI
Thruk interface
Use Shinken with ...
Use Shinken with Centreon
Use Shinken with Graphite
Use Shinken with Multisite
Use Shinken with Nagvis
Use Shinken with Old CGI and VShell
Use Shinken with PNP4Nagios
Use Shinken with Thruk
Use Shinken with WebUI
Security and Performance Tuning
Security Considerations
Tuning Shinken For Maximum Performance
Scaling a Shinken installation
Shinken performance statistics
How to monitor ...
Monitoring an Asterisk server
check_wmi_plus.pl for shinken on windows
Monitoring Active Directory
Monitoring a DHCP server
Monitoring Microsoft Exchange
Monitoring a IIS server
Monitoring Linux Devices
Monitoring Linux Devices
Monitoring a Linux via a Local Agent
Monitoring a Linux via SNMP
Monitoring Publicly Available Services
Monitoring a printer
Monitoring Network Devices
Monitoring Windows Devices
Monitoring Microsoft Mssql server
Monitoring MySQL
Monitoring VMware Machines
Monitoring Microsoft Mssql server
Monitoring MySQL
Monitoring Publicly Available Services
Monitoring an Oracle database server
Monitoring a printer
Monitoring Network Devices
Monitoring VMware Machines
Monitoring Windows witn NSClient++
Monitoring Windows Devices
How to contribute
Shinken packs
Shinken modules and Shinken packs
Help the Shinken project
Getting Help and Ways to Contribute
Shinken Package Manager
Development
Shinken Programming Guidelines
Test Driven Development
Nagios Plugin API
Developing Shinken Daemon Modules
Hacking the Shinken Code
Shinken modules
Amazon AWS/EC2 import
Amazon AWS/EC2 import
The distributed retention modules
How to enable and use Livestatus module
Exporting data for reporting
Monitoring Linux System with Glances and checkglances.py
Shinken GLPI integration
Ip Tag module
Ubuntu Landscape import
Shinken Livestatus API
NSCA module
Retention troubleshooting
NRPE Module
Extending Shinken
Broker modules
TSCA (Thrift Service Check Acceptor)
VMWare Arbiter module
Web Service Module
SNMP module
WebUI module
Reference
shinken
shinken Package
clients Package
daemons Package
discovery Package
misc Package
objects Package
webui Package
Indices and tables
¶
Index
Module Index
Search Page
Read the Docs
v: documentation
Versions
latest
documentation
Downloads
PDF
HTML
Epub
On Read the Docs
Project Home
Builds
Free document hosting provided by
Read the Docs
.