Icinga v16 En

  • View

  • Download

Embed Size (px)

Text of Icinga v16 En

Icinga Version 1.6 Documentation

Icinga Version 1.6 Documentation Next

Icinga Version 1.6 DocumentationCopyright 2009-2011 Icinga Development Team. Portions copyright by Nagios/Icinga community members - see the THANKS file in the Icinga core sources for more information.. Credits to Yoann LAMY for creating the Vautour Style we use for the Icinga Classic UI Icinga is licensed under the terms of the GNU General Public License Version 2 as published by the Free Software Foundation. This gives you legal permission to copy, distribute and/or modify Icinga under certain conditions. Read the LICENSE file in the Icinga distribution or read the online version of the license for more details. Icinga is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE WARRANTY OF DESIGN, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE. Nagios is licensed under the terms of the GNU General Public License Version 2 as published by the Free Software Foundation. This gives you legal permission to copy, distribute and/or modify Nagios under certain conditions. Read the LICENSE file in the Nagios distribution or read the online version of the license for more details. Nagios and the Nagios logo are registered trademarks of Ethan Galstad. All other trademarks, servicemarks, registered trademarks, and registered servicemarks mentioned herein may be the property of their respective owner(s). The information contained herein is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE WARRANTY OF DESIGN, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE. 2011.11.30


Icinga Version 1.6 Documentation

Revision History Revision 1.6 1.6 Icinga Documentation Revision 1.x 1.x Icinga Documentation Revision 0.1 First Release 2009-08-12 2010/2011 2011-11-30

Table of Contents 1. About About Icinga Whats New in Icinga 1.6 2. Getting Started Advice for beginners Quickstart Installation Guides Icinga Quickstart Icinga Quickstart FreeBSD Icinga with IDOUtils Quickstart Icinga and IDOUtils Quickstart on FreeBSD Links to other published Howtos Upgrading (to) Icinga Upgrading IDOUtils Database Monitoring Windows Machines Monitoring Linux/Unix Machines Monitoring Netware Servers Monitoring Network Printers Monitoring Routers and Switches Monitoring Publicly Available Services 3. Configuring Icinga Configuration Overview Main Configuration File Options Object Configuration Overview Object Definitions Host definition Hostgroup Definition Service Definition Servicegroup Definition Contact Definition Contactgroup Definition Timeperiod Definition Command Definition Servicedependency Definition Serviceescalation Definition Hostdependency Definition Hostescalation Definition Hostextinfo Definition Serviceextinfo Definition


Icinga Version 1.6 Documentation

Module Definition Custom Object Variables CGI Configuration File Options Authentication And Authorization In The CGIs 4. Running Icinga Verifying Your Configuration Starting and Stopping Icinga 5. The Basics Icinga Plugins Understanding Macros and How They Work Standard Macros in Icinga Host Checks Service Checks Active Checks Passive Checks State Types Time Periods Determining Status and Reachability of Network Hosts Notifications Notifications: Examples and troubleshooting 6. User Interfaces Icinga Classic UI: Information On The CGIs Information On CGI parameters Executing CGIs on the command line Installation of the Icinga-Web Frontend Upgrading Icinga-Web and Icinga-Web Database Configuration Overview of Icinga-Web Introduction to Icinga-Web Introduction to Icinga-Web (>= 1.6.x) Integration of PNP4Nagios into Icinga-Web 7. 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 Escalation Condition On-Call Rotations Monitoring Service and Host Clusters Host and Service Dependencies State Stalking Performance Data Scheduled Downtime Using The Embedded Perl Interpreter Adaptive Monitoring Predictive Dependency Checks Cached Checks Passive Host State Translation Service and Host Check Scheduling Custom CGI Headers and Footers


Icinga Version 1.6 Documentation

Object Inheritance Time-Saving Tricks For Object Definitions 8. Security and Performance Tuning Security Considerations Enhanced CGI Security and Authentication Tuning Icinga For Maximum Performance Fast Startup Options Large Installation Tweaks Using The Icingastats Utility Graphing Performance Info With PNP4Nagios Temporary Data 9. Integration With Other Software Integration Overview SNMP Trap Integration TCP Wrapper Integration MKLiveStatus Integration Installation of the Icinga-Reporting with JasperServer 10. Additional software Icinga Addons NRPE NSCA 11. Development Icinga Plugin API Developing Plugins For Use With Embedded Perl List of External Commands Installation and use of the Icinga API The Icinga-Web REST API 12. IDOUtils Introduction Purpose Design Overview Instances Installation Components Overview IDOMOD LOG2IDO FILE2SOCK IDO2DB. IDO2DB Configuration of IDOUtils IDOMOD config options IDO2DB config options Example Configurations Single Server, Single Instance Setup Single Server, Multiple Instance Setup Single Server, Single Instance Log File Import IDOUtils Database Model Central Tables Debugging Tables Historical Tables Current Status Tables Configuration Tables Database changes/alterations


Icinga Version 1.6 Documentation

Index List of Figures 3.1. Example of new header 6.1. Icinga-Web login screen 6.2. Icinga-Web overview 6.3. Icinga-Web top menu 6.4. Icinga-Web live search 6.5. Icinga-Web status cronk 6.6. Icinga-Web data cronks 6.7. Icinga-Web tactical overview cronks 6.8. Icinga-Web reporting cronk 6.9. Icinga-Web misc cronks 6.10. Icinga-Web main screen 6.11. Icinga-Web host status 6.12. Icinga-Web service status 6.13. Icinga-Web hostgroup status 6.14. Icinga-Web log 6.15. Icinga-Web tackle cronk 6.16. Icinga-Web cronk bar 6.17. Icinga-Web cronk bar 6.18. Icinga-Web host commands 6.19. Icinga-Web service commands 6.20. Icinga-Web filter restriction 6.21. Icinga-Web filter condition 6.22. Icinga-Web filter active 6.23. Icinga-Web top menu admin 6.24. Icinga-Web user admin 6.25. Icinga-Web edit user 6.26. Icinga-Web group admin 6.27. Icinga-Web groups 6.28. Icinga-Web logs 6.29. Icinga-Web Tasks 6.30. PNP4Nagios integrated in Icinga-Web 7.1. Cached checks 8.1. Average Host / Service Check Latency 8.2. Service Statistics 8.3. Host Statistics 8.4. Average Execution Times 8.5. External Commands 8.6. External Command Buffers 8.7. Cached Host and Service Checks 8.8. Average State Changes 9.1. Icinga reporting 10.1. NRPE 10.2. NRPE remote 10.3. NSCA 12.1. Multiple instances 12.2. Future development: One Instance, multiple databases 12.3. Instance names based on geographical locations 12.4. Instance names based on their purpose 12.5. Loaded IDOMOD Event broker Module


Icinga Version 1.6 Documentation

12.6. IDOMOD Capabilities 12.7. LOG2IDO Utility 12.8. FILE2SOCK Utility 12.9. IDO2DB Daemon 12.10. IDO2DB with multiple Clients 12.11. Single Server, Single Instance Setup 12.12. Single Server, Multiple Instance Setup 12.13. Single Server, Single Instance Log File Import 12.14. Relationship of Central Tables 12.15. Relationship of Debugging Tables 12.16. Relationship of Historical Tables 12.17. Relationship of Current Status Tables 12.18. Relationship of Configuration Tables Next Chapter 1. About 2009-2012 Icinga Development Team, http://www.icinga.org


Chapter 1. About

Chapter 1. About Prev Next

Chapter 1. AboutTable of Contents About Icinga Whats New in Icinga 1.6 Prev Icinga Version 1.6 Documentation Home Next About Icinga

2009-2012 Icinga Development Team, http://www.icinga.org


About Icinga

About Icinga Prev Chapter 1. About Next

About IcingaWhat is Icinga? Icinga is a monitoring system checking hosts and services you specify and notifying you when things go wrong and when they recover. It runs on multiple Linux distributions (including Fedora, Ubuntu, and openSuSE) as well as several Unix platforms (including Solaris and HP). The systems to be monitored can be nearly anything connected to a network. Some of the many features of Icinga include: Monitoring of network services (SMTP, POP3, HTTP, NNTP, PING, etc.) Monitoring of host resources (CPU load, disk usage, etc.) Simple plugin design that allows users to easily develop their own service checks Parallelized service checks Ability to define network host hierarchy using "parent" hosts, allowing detection of and distinction between hosts that are down and those that are unreachable Contact notifications when service or host problems occur and get resolved (via email, pager, or user-defined method) Ability to define event handlers to be run during service or host events for proactive problem resolution Automatic log file rotation Support for implementing redundant monitoring hosts Optional classic web interface for viewing current network status, notification and problem history, log file, etc. Optional new Icinga web interface based on Icinga Core, IDOUtils, API using a modern and refreshed web 2.0 GUI showing current states, historical information, using cronks and filters, creating reports with multilanguage support System requirements


About Icinga

As mentioned above youll need a machine running Linux or a Unix variant. If there is no precompiled version or if you want to compile from source you need a C compiler like gcc. Note Some compilers may not be suitable. That includes the C compiler on HP-UX which is used to compile a new kernel. You may also want to have TCP/IP configured as most checks will require access via the network. You are not req