Shinken Manual
About
About Shinken
Getting Started
Advice for Beginners
Installations
Upgrading Shinken
Configuring Shinken
Configuration Overview
Main Configuration File (shinken.cfg) 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
Monitoring 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
Setup Network and logical dependencies in Shinken
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
Snapshots
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
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
Businessimpact modulations
Check modulations
Macro modulations
Result 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
Shinken Architecture
Troubleshooting
FAQ - Shinken troubleshooting
Integration With Other Software
Integration Overview
SNMP Trap Integration
TCP Wrappers Integration
Use Shinken with 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 WebUI
Security and Performance Tuning
Security Considerations
Tuning Shinken For Maximum Performance
Scaling a Shinken installation
Shinken performance statistics
Graphing Performance Info With MRTG and nagiostats
How to monitor ...
Monitoring Active Directory
Monitoring Asterisk servers
Monitoring DHCP servers
Monitoring IIS servers
Monitoring Linux devices
Monitoring Linux devices
Monitoring Linux devices via a Local Agent
Monitoring Linux devices via SNMP
Monitoring Microsoft Exchange
Monitoring Microsoft SQL databases
Monitoring MySQL databases
Monitoring Routers and Switches
Monitoring Network devices
Monitoring Oracle databases
Monitoring Printers
Monitoring Publicly Available Services
Monitoring VMware hosts and machines
Monitoring Windows devices
Monitoring Windows devices via NSClient++
Monitoring Windows devices via WMI
How to contribute
Shinken packs
Shinken modules
Getting Help and Ways to Contribute
Shinken Package Manager
Development
Shinken Programming Guidelines
Test Driven Development
Shinken Plugin API
Developing Shinken Daemon Modules
Hacking the Shinken Code
Shinken documentation
Deprecated
Feature comparison between Shinken and Nagios
Shinken modules
Reference
Exceptions
shinken
shinken Package
clients Package
daemons Package
discovery Package
misc Package
objects Package
webui Package
Shinken Manual
Docs
»
The Basics
Edit on GitHub
The Basics
ΒΆ
Setting up a basic Shinken Configuration
Default Shinken configuration
Configure the Shinken Daemons
Daemon declaration in the global configuration
What’s next
Monitoring 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
Understanding Macros and How They Work
Macros
Macro Substitution - How Macros Work
Example 1: Host Address Macro
Example 2: Command Argument Macros
On-Demand Macros
On-Demand Group Macros
Custom Variable Macros
Macro Cleansing
Macros as Environment Variables
Available Macros
Standard Macros in Shinken
Macro Validity
Macro Availability Chart
Macro Descriptions
Notes
Host Checks
Introduction
When Are Host Checks Performed?
Cached Host Checks
Dependencies and Checks
Parallelization of Host Checks
Host States
Host State Determination
Host State Changes
Service Checks
Introduction
When Are Service Checks Performed?
Cached Service Checks
Dependencies and Checks
Parallelization of Service Checks
Service States
Service State Determination
Services State Changes
Active Checks
Introduction
How Are Active Checks Performed?
When Are Active Checks Executed?
Passive Checks
Introduction
Uses For Passive Checks
How Passive Checks Work
Enabling Passive Checks
Submitting Passive Service Check Results
Submitting Passive Host Check Results
Passive Checks and Host States
Submitting Passive Check Results From Remote Hosts
State Types
Introduction
Service and Host Check Retries
Soft States
Hard States
Example
Time Periods
Introduction
Precedence in Time Periods
How Time Periods Work With Host and Service Checks
How Time Periods Work With Contact Notifications
How Time Periods Work With Notification Escalations
How Time Periods Work With Dependencies
Determining Status and Reachability of Network Hosts
Introduction
Example Network
Defining Parent/Child Relationships
Reachability Logic in Action
UNREACHABLE States and Notifications
Notifications
Introduction
When Do Notifications Occur?
Who Gets Notified?
What Filters Must Be Passed In Order For Notifications To Be Sent?
Program-Wide Filter:
Service and Host Filters:
Contact Filters:
Notification Methods
Notification Type Macro
Detailled Notification Macros
Helpful Resources
Active data acquisition modules
Overview
SNMP data acquisition module
NRPE data acquisition module
Notes on community Packs
Setup Network and logical dependencies in Shinken
Network dependencies
Logical dependencies
Update Shinken