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
»
Configuring Shinken
Edit on GitHub
Configuring Shinken
ΒΆ
Configuration Overview
Introduction
Main Configuration File
Resource File(s)
Object Definition Files
Main Configuration File Options
Config File Location and sample
Broker Modules
Arbiter, Receiver, Poller, Reactionner Modules
Path, users and log variables
Log File
Log Level
Human format for log timestamp
Object Configuration File
Object Configuration Directory
Resource File
Arbiter Daemon User
Arbiter Daemon user Group
Bypass security checks for the Arbiter daemon
Notifications Option
Log Rotation Method (Not fully implemented)
External Command Check Option
External Command File
Arbiter Lock File
State Retention Option (Not implemented)
State Retention File
Automatic State Retention Update Interval
Scheduling parameters
Service/Host Check Execution Option
Passive Service/Host Check Acceptance Option
Event Handler Option
Event Handler during downtimes
Syslog Logging Option
Notification Logging Option
Service/Host Check Retry Logging Option (Not implemented)
Event Handler Logging Option
Initial States Logging Option (Not implemented)
External Command Logging Option
Passive Check Logging Option (Not implemented)
Global Host/Service Event Handler Option (Not implemented)
Maximum Host/Service Check Spread
Timing Interval Length
Tuning and advanced parameters
Old CGI related parameter
Unused parameters
Object Configuration Overview
What Are Objects?
Where Are Objects Defined?
How Are Objects Defined?
Objects Explained
Hosts
Host Groups
Services
Service Groups
Contacts
Contact Groups
Timeperiods
Commands
Object Definitions
Introduction
Sample Configuration Files
Object Types
Custom Object Variables
Introduction
Custom Variable Basics
Examples
Custom Variables As Macros
Custom Variables And Inheritance
Main advanced configuration
Tuning and advanced parameters
Performance data parameters
Performance Data Processor Command Timeout
Performance Data Processing Option
Host/Service Performance Data Processing Command
Host/Service Performance Data File
Host Performance Data File Template
Service Performance Data File Template
Host/Service Performance Data File Mode
Host/Service Performance Data File Processing Interval (Unused)
Host/Service Performance Data File Processing Command (Unused)
Advanced scheduling parameters
Passive Host Checks Are SOFT Option (Not implemented)
Predictive Host/Service Dependency Checks Option (Unused)
Orphaned Host/Service Check Option
Max Plugins Output Length
Enable problem/impacts states change
Soft State Dependencies Option (Not implemented)
Performance tuning
Cached Host/Service Check Horizon
Large Installation Tweaks Option
Environment Macros Option
Flapping parameters
Flap Detection Option
Low Service/Host Flap Threshold
High Service/Host Flap Threshold
Flap History
Commands/checks timeout
Service/Host Check Timeout
Various commands Timeouts
Old Obsess Over commands
Obsess Over Services Option
Obsessive Compulsive Service Processor Command
Obsess Over Hosts Option
Obsessive Compulsive Host Processor Command
Freshness check
Host/Service Freshness Checking Option
Host/Service Freshness Check Interval
Additional Freshness Threshold Latency Option (Not implemented)
All the others :)
Date Format (Not implemented)
Timezone Option
Illegal Object Name Characters
Illegal Macro Output Characters
Regular Expression Matching Option (Not implemented)
True Regular Expression Matching Option (Not implemented)
Administrator Email Address (unused)
Administrator Pager (unused)
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
.