Tipps & Tricks Icinga Core, Classic UI, IDOUtils, Web

Dear visitor, welcome to Monitoring-Portal.
Although this is a german monitoring forum, please don't hesitate to post in English. Nearly everybody here understands you and will answer in English as well.
If this is your first visit here, please read the Help. It explains how this page works. You must be registered before you can use all the page's features. Please use the registration form to register here or read more information about the registration process. If you are already registered, please login here.

dnsmichi

Super Moderator

Posts: 5,986

Birthday: May 30th 1983 (29)

Gender: male

Location: Nürnberg

Occupation: Consultant / Developer beim besten Arbeitgeber der Welt @netways

Number of monitoring servers: Icinga: 4x dev, 10++ prod, Icinga2: 2x dev

Nagios Version: s/nagios/icinga/

Icinga Version: 1.9.1 / GIT

Distributed monitoring: Ja

Redundant monitoring: Ja

Number of hosts: 1000+

Number of services: 15000+

OS: RHEL, Debian, SUSE

Plugin Version: 1.4.16

IDO-Version: 1.9.1 / GIT MySQL/Postgresql/Oracle

Other Addons: Icinga Web, PNP, check_multi, inGraph, EventDB, LConf

Tuesday, December 29th 2009, 2:21pm

Tipps & Tricks Icinga Core, Classic UI, IDOUtils, Web

https://wiki.icinga.org holds all available information and is meant to be a community wiki appreciating your input too :-)

General

Icinga Core and Icinga Web are seperated packages (icinga-1.5.1.tar.gz and icinga-web-1.5.2.tar.gz) and will therefore share the major version (1.5) but minor bugfix releases remain independant (1.5.1 vs 1.5.2).

Icinga 2 will be a new core rewritten from scratch with a different architecture - https://www.icinga.org/2012/10/25/icinga-2-v-0-0-1-released/

Icinga Core
- Core 1.x
- Classic UI (CGIs, HTML, JS)
- IDOUtils (Database output, MySQL/Postgresql/Oracle)
- IcingaMQ - unfinished prototype, Icinga 2 is announced and being worked on instead.
Icinga Web
- Web (new 2.0 web frontend, based on IDOUtils DB source)
- Doctrine API DB layer (replacing old Icinga API)
- Translations (pootle for multiple language support)
- REST API
- Mobile (using API)
Icinga Docs
- english
- german

Design

Icinga Web is based on an internal API (Doctrine)
- config, status and historical data: IDOUtils DB
- commands: commandpipe via shell or ssh
- user and session management: own DB (named icinga_web by default)
IDOUtils DB gets filled by ido2db daemon (monitor that process - 1 parent, 1 child per idomod connection) receiving data from idomod via socket
idomod is loaded as event broker module to the Core (make sure either with broker_module OR via module definition
Core dumps events and data to registered neb callbacks, e.g. onto idomod

Installation

https://www.icinga.org/download/
https://www.icinga.org/download/packages/

Important: By default, there are 2 databases. IDOUtils (named icinga) and Web (named icinga_web) !!!

Icinga Core with IDOUtils http://docs.icinga.org/latest/en/quickstart-idoutils.html - use packages from your distribution
Icinga-Web http://docs.icinga.org/latest/en/icinga-web-scratch.html

Performance Tuning

https://wiki.icinga.org/display/howtos/Performance+Tuning

Errors

https://wiki.icinga.org/display/testing/Home
https://wiki.icinga.org/display/Dev/Debug

>>> Where?

Core
- syslog, icinga.log
- icinga.debug (icinga.cfg: debug_level=-1, debug_verbosity=2)
- https://wiki.icinga.org/display/testing/Icinga+Core+Testing
Classic UI
- apache log
- cgis on shell output (and debug)
- https://wiki.icinga.org/display/testing/…ssic+UI+Testing
IDOUtils
- syslog, icinga.log
- idomod.debug / ido2db.debug idomod.cfg / ido2db.cfg: debug_level=-1, debug_verbosity=2
- https://wiki.icinga.org/display/testing/…DOUtils+Testing
Web
- apache log, web log (default in $prefix logs/)
- test data errors
- https://wiki.icinga.org/display/testing/Icinga+Web+Testing

>>> Config Changes in Icinga Web

clear config cache via bin/clearcache.sh or web admin task

>>> Icinga Web shows a blank page

Apache Error Logs => mod_rewrite enabled, phpdeps ok?
.htaccess/vhost config => paths ok?

>>> Icinga Web no data?

DB access denied => check config in databases.xml
debug the cronks - https://wiki.icinga.org/display/testing/…-DebugtheCronks

>>> IDOUtils DB no data?

"Error writing to data sink" => check IDOUtils
nothing => check if ido2db is running, and idomod is loaded as core module http://docs.icinga.org/latest/en/quickstart-idoutils.html
DB schema mismatch? => check the logs and follow the upgrade path: http://docs.icinga.org/latest/en/upgrading_idoutils.html
Sockets correct? => unix-socket or tcp-socket (tcp with ssl if desired)

More details on the wiki in the howto section

Stand: 12102011

+++ Icinga / LConf Developer +++ Senior Consultant at []NETWAYS> +++
+++ Icinga 1.9 || Icinga 2 +++ Icinga Support || IRC +++

This post has been edited 9 times, last edit by "dnsmichi" (Oct 26th 2012, 12:41am)

Go to the top of the page

DrPaua

Beginner

Posts: 6

Number of monitoring servers: 1

Nagios Version: Icinga 1.0

Distributed monitoring: Nein

Redundant monitoring: Nein

Number of hosts: 5

Number of services: 18

OS: SLES 10 SP2

Plugin Version: 1.4.14

NDO Version: 1

Monday, March 29th 2010, 2:54pm

Kann ich mit der API die Überwachung von Windows-Tasks programmieren ohne dass ich den NSClient o.Ä. installiert habe? Oder die Existenz bestimmter Dateien? Das einzige was hier auf den Servern ist, ist ServerView und halt FW und SNMP angepasst...

Go to the top of the page

Asa

Professional

Posts: 877

Gender: male

Location: Oldenburg

Occupation: Angestellter

Number of monitoring servers: 3

Hobbies: Technik aller Art

Nagios Version: n/a

Icinga Version: 1.7.2

Distributed monitoring: Nein

Redundant monitoring: Nein

Number of hosts: ~1000

Number of services: ~10000

OS: SLES11

Plugin Version: 1.4.13

Other Addons: NagTrap, SNMPTT, Lilac, PNP, Thruk und mehr ;-)

Monday, March 29th 2010, 4:14pm

Quoted from "DrPaua"

Kann ich mit der API die Überwachung von Windows-Tasks programmieren ohne dass ich den NSClient o.Ä. installiert habe? Oder die Existenz bestimmter Dateien? Das einzige was hier auf den Servern ist, ist ServerView und halt FW und SNMP angepasst...

Die Icinga API hat nichts mit der Überwachung von Clients zutun :huh:

Dafür musst du entweder - wie du schon sagtest - auf Clients wie den NSClient zurückgreifen, oder du machst es per SNMP/WMI o.Ä.

NSClient++ Fan

Zitat von »http://twitter.com/motherofnagios«

There is a "Nagios Workshop" in Germany. Not sure if this is compliant with our trademark policy.

Go to the top of the page

DrPaua

Beginner

Posts: 6

Number of monitoring servers: 1

Nagios Version: Icinga 1.0

Distributed monitoring: Nein

Redundant monitoring: Nein

Number of hosts: 5

Number of services: 18

OS: SLES 10 SP2

Plugin Version: 1.4.14

NDO Version: 1

Monday, March 29th 2010, 4:43pm

OK, danke, das habe ich aus dem, was ich bisher über die API gesehen habe, nicht herauslesen können. Meinst du mit

Quoted from "Asa"

oder du machst es per SNMP/WMI o.Ä.

"SNMP oder WMI" oder "SNMP in Kombination mit WMI"? Und wenn du o.Ä. schreibst, was gibt es denn noch für Möglichkeiten?

Go to the top of the page

dnsmichi

Super Moderator

Posts: 5,986

Birthday: May 30th 1983 (29)

Gender: male

Location: Nürnberg

Occupation: Consultant / Developer beim besten Arbeitgeber der Welt @netways

Number of monitoring servers: Icinga: 4x dev, 10++ prod, Icinga2: 2x dev

Nagios Version: s/nagios/icinga/

Icinga Version: 1.9.1 / GIT

Distributed monitoring: Ja

Redundant monitoring: Ja

Number of hosts: 1000+

Number of services: 15000+

OS: RHEL, Debian, SUSE

Plugin Version: 1.4.16

IDO-Version: 1.9.1 / GIT MySQL/Postgresql/Oracle

Other Addons: Icinga Web, PNP, check_multi, inGraph, EventDB, LConf

Wednesday, April 7th 2010, 7:47am

bitte fuer derartige fragen einen eigenen thread erstellen, sonst wirds hier zu unuebersichtlich ;-)

edit oben - icinga-web configure + make flags adaptiert.

+++ Icinga / LConf Developer +++ Senior Consultant at []NETWAYS> +++
+++ Icinga 1.9 || Icinga 2 +++ Icinga Support || IRC +++

Go to the top of the page

jmosshammer

Intermediate

Posts: 193

Number of monitoring servers: 1

Nagios Version: 1

Distributed monitoring: Nein

Redundant monitoring: Nein

Number of hosts: 1

Number of services: 1

OS: 1

Plugin Version: 1

NDO Version: 1

Monday, April 12th 2010, 4:54pm

Weil wirs gerade hatten:

>>> Änderungen bei Icinga-Web Configs (z.B. Änderungen der API-DB-Verbindung in der icinga.xml) werden nicht berücksichtigt:
* Inhalt von pfad-zu-icinga-web/app/cache/ löschen

NETWAYS GmbH http://www.netways.de
NETWAYS Blog http://blog.netways.de

Go to the top of the page

dnsmichi

Super Moderator

Posts: 5,986

Birthday: May 30th 1983 (29)

Gender: male

Location: Nürnberg

Occupation: Consultant / Developer beim besten Arbeitgeber der Welt @netways

Number of monitoring servers: Icinga: 4x dev, 10++ prod, Icinga2: 2x dev

Nagios Version: s/nagios/icinga/

Icinga Version: 1.9.1 / GIT

Distributed monitoring: Ja

Redundant monitoring: Ja

Number of hosts: 1000+

Number of services: 15000+

OS: RHEL, Debian, SUSE

Plugin Version: 1.4.16

IDO-Version: 1.9.1 / GIT MySQL/Postgresql/Oracle

Other Addons: Icinga Web, PNP, check_multi, inGraph, EventDB, LConf

Monday, September 20th 2010, 9:23am

everything related to web is now fulfilled within the docs in the icinga web section at the bottom - please open up docs issues if you have something to add

https://dev.icinga.org/projects/icinga-docs/issues

the other way around - several testing guides can be found here

https://dev.icinga.org/projects/icinga-d…nt/wiki#Testing

stumble around throughout the dev tracker wikis - specific thoughts and howtos are added in the sub project sections, just as dev guides for icinga web :-)

https://dev.icinga.org/projects/icinga-web/wiki

+++ Icinga / LConf Developer +++ Senior Consultant at []NETWAYS> +++
+++ Icinga 1.9 || Icinga 2 +++ Icinga Support || IRC +++

Go to the top of the page

neocoretech

Beginner

Posts: 6

Gender: male

OS: Linux/Windows

Friday, March 18th 2011, 3:07pm

having problems with icinga-api 1.3.0 not returning any hosts or services...

discussion in thread:
http://www.nagios-portal.org/wbb/index.p…&threadID=22099

This post has been edited 1 times, last edit by "neocoretech" (Mar 18th 2011, 3:28pm)