Difference between revisions of "Icinga"

From HackerNet
Jump to: navigation, search
Line 12: Line 12:
  
 
'''Icinga's user interface''' som hämtar data från IDODBn och visar upp resultatet. Används också för att skicka kommandon mot Core.
 
'''Icinga's user interface''' som hämtar data från IDODBn och visar upp resultatet. Används också för att skicka kommandon mot Core.
 +
 +
==Förberedelse==
 +
Man behöver en databas att använda som en IDODB, och lägga till några nya repon.
 +
===Repository===
 +
====Debian====
 +
'''Icinga Debian repo'''
 +
wget -O - http://packages.icinga.org/icinga.key | apt-key add -
 +
echo deb http://packages.icinga.org/debian icinga-jessie main >> /etc/apt/sources.list
 +
echo deb-src http://packages.icinga.org/debian icinga-jessie main >> /etc/apt/sources.list
 +
apt-get update
 +
 +
'''Debian backports repo'''
 +
echo deb http://ftp.se.debian.org/debian/ jessie-backports main >> /etc/apt/sources.list
 +
apt-get update
 +
 +
'''Debmon repo'''
 +
wget -O - http://debmon.org/debmon/repo.key 2>/dev/null | apt-key add -
 +
echo 'deb http://debmon.org/debmon debmon-jessie main' >/etc/apt/sources.list.d/debmon.list
 +
apt-get update
 +
 +
====Ubuntu====
 +
'''Icinga Ubuntu repo''''
 +
wget -O - http://packages.icinga.org/icinga.key | apt-key add -
 +
echo deb http://packages.icinga.org/ubuntu icinga-trusty main >> /etc/apt/sources.list
 +
echo deb-src http://packages.icinga.org/ubuntu icinga-trusty main >> /etc/apt/sources.list
 +
apt-get update
 +
 +
'''Icinga PPA repo'''
 +
add-apt-repository ppa:formorer/icinga
 +
apt-get update
  
 
==Installation==
 
==Installation==
 +
För att installera Icinga2 core skriv,
 +
apt-get install icinga2
 +
 +
Utan plugins vet inte Icinga hur den ska kolla en tjänst. Enklast är att tanka hem en färdig bundle med plugins.
 +
apt-get install nagios-plugins
 +
 +
==Kommandon==
 +
Icinga har en hög olika kommandon. [http://docs.icinga.org/icinga2/latest/doc/module/icinga2/chapter/cli-commands#cli-command-feature CLI kommandon]
 +
 +
===Features===
 +
Kolla vilka features som är enablat. Basic installation så är bara <code>checker, notification och mainlog</code> enablat.
 +
icinga2 feature list
 +
 +
===systemctl/init===
 +
Kommandona gör samma sak för både systemctl och init.
 +
systemctl status icinga2
 +
/etc/init.d/icinga2 status
 +
 +
 +
==Konfiguration==
 +
{| class="wikitable"
 +
|+Kommando beskrivning
 +
|-
 +
|start||The start action starts the Icinga 2 daemon.
 +
|-
 +
|stop||The stop action stops the Icinga 2 daemon.
 +
|-
 +
|restart||The restart action is a shortcut for running the stop action followed by start.
 +
|-
 +
|reload||The reload action sends the HUP signal to Icinga 2 which causes it to restart. Unlike the restart action reload does not wait until Icinga 2 has restarted.
 +
|-
 +
|checkconfig||The checkconfig action checks if the /etc/icinga2/icinga2.conf configuration file contains any errors.
 +
|-
 +
|status||The status action checks if Icinga 2 is running.
 +
|}
 +
 +
 +
 +
 +
 +
 +
{| class="wikitable"
 +
!|Path!!Description
 +
|-
 +
|/etc/icinga2||Contains Icinga 2 configuration files.
 +
|-
 +
|/etc/init.d/icinga2||The Icinga 2 init script.
 +
|-
 +
|/usr/sbin/icinga2||The Icinga 2 binary.
 +
|-
 +
|/usr/share/doc/icinga2||Documentation files that come with Icinga 2.
 +
|-
 +
|/usr/share/icinga2/include||The Icinga Template Library and plugin command configuration.
 +
|-
 +
|/var/run/icinga2||PID file.
 +
|-
 +
|/var/run/icinga2/cmd||Command pipe and Livestatus socket.
 +
|-
 +
|/var/cache/icinga2||status.dat/objects.cache, icinga2.debug files
 +
|-
 +
|/var/spool/icinga2||Used for performance data spool files.
 +
|-
 +
|/var/lib/icinga2||Icinga 2 state file, cluster log, local CA and configuration files.
 +
|-
 +
|/var/log/icinga2||Log file location and compat/ directory for the CompatLogger feature.
 +
|}

Revision as of 20:33, 4 August 2015

Icinga är ett forkat project av Nagios det betyder att Icinga är bakåtkompatibel med nästan alla Nagios plugins och add-ons skrivna för Nagios.

Icinga skapades för att fixa brister i Nagios utveckling och för att lägga till nya funktioner som ett moderna web 2.0 interface, fler stöd för databaser(Oracle, PostgreSQL och MySQL) och ett REST API. Dom släpper också patcher oftare och snabbare än vad Nagios gjorde.

Arkitektur

Arkitekturen

Icinga är uppdelat i tre olika delar.

Core sköter all övervakning sparar alla resultat och data på IDO DBn. Den skickar också ut en alert om något har hänt.

Icinga Data Out Database (IDODB) fungerar som lagringsyta för all övervakningsdata som add-ons eller webinterfacet kan hämta.

Icinga's user interface som hämtar data från IDODBn och visar upp resultatet. Används också för att skicka kommandon mot Core.

Förberedelse

Man behöver en databas att använda som en IDODB, och lägga till några nya repon.

Repository

Debian

Icinga Debian repo

wget -O - http://packages.icinga.org/icinga.key | apt-key add -
echo deb http://packages.icinga.org/debian icinga-jessie main >> /etc/apt/sources.list 
echo deb-src http://packages.icinga.org/debian icinga-jessie main >> /etc/apt/sources.list
apt-get update

Debian backports repo

echo deb http://ftp.se.debian.org/debian/ jessie-backports main >> /etc/apt/sources.list
apt-get update

Debmon repo

wget -O - http://debmon.org/debmon/repo.key 2>/dev/null | apt-key add -
echo 'deb http://debmon.org/debmon debmon-jessie main' >/etc/apt/sources.list.d/debmon.list
apt-get update

Ubuntu

Icinga Ubuntu repo'

wget -O - http://packages.icinga.org/icinga.key | apt-key add -
echo deb http://packages.icinga.org/ubuntu icinga-trusty main >> /etc/apt/sources.list
echo deb-src http://packages.icinga.org/ubuntu icinga-trusty main >> /etc/apt/sources.list
apt-get update

Icinga PPA repo

add-apt-repository ppa:formorer/icinga
apt-get update

Installation

För att installera Icinga2 core skriv,

apt-get install icinga2

Utan plugins vet inte Icinga hur den ska kolla en tjänst. Enklast är att tanka hem en färdig bundle med plugins.

apt-get install nagios-plugins

Kommandon

Icinga har en hög olika kommandon. CLI kommandon

Features

Kolla vilka features som är enablat. Basic installation så är bara checker, notification och mainlog enablat.

icinga2 feature list

systemctl/init

Kommandona gör samma sak för både systemctl och init.

systemctl status icinga2
/etc/init.d/icinga2 status


Konfiguration

Kommando beskrivning
start The start action starts the Icinga 2 daemon.
stop The stop action stops the Icinga 2 daemon.
restart The restart action is a shortcut for running the stop action followed by start.
reload The reload action sends the HUP signal to Icinga 2 which causes it to restart. Unlike the restart action reload does not wait until Icinga 2 has restarted.
checkconfig The checkconfig action checks if the /etc/icinga2/icinga2.conf configuration file contains any errors.
status The status action checks if Icinga 2 is running.




Path Description
/etc/icinga2 Contains Icinga 2 configuration files.
/etc/init.d/icinga2 The Icinga 2 init script.
/usr/sbin/icinga2 The Icinga 2 binary.
/usr/share/doc/icinga2 Documentation files that come with Icinga 2.
/usr/share/icinga2/include The Icinga Template Library and plugin command configuration.
/var/run/icinga2 PID file.
/var/run/icinga2/cmd Command pipe and Livestatus socket.
/var/cache/icinga2 status.dat/objects.cache, icinga2.debug files
/var/spool/icinga2 Used for performance data spool files.
/var/lib/icinga2 Icinga 2 state file, cluster log, local CA and configuration files.
/var/log/icinga2 Log file location and compat/ directory for the CompatLogger feature.