Observium
Observium on ilmainen valvontaohjelma. Ohjelmalla voi valvoa palvelimia ja verkkolaitteita. Palvelimen tai verkkolaitteen vikaantuessa observium lähettää käyttäjälle sähköpostiviestin.
Sisällysluettelo
Asentaminen ja konfigurointi
Asenna seuraavat paketit pakettihallinnasta
apt-get install libapache2-mod-php5 php5-cli php5-mysql php5-gd php5-mcrypt php5-json php-pear snmp fping mysql-server mysql-client python-mysqldb rrdtool subversion whois mtr-tiny ipmitool graphviz imagemagick
Luo hakemisto Observium:ille ja siirrytään siihen
mkdir -p /opt/observium && cd /opt
Ladataan Observium free editon
wget http://www.observium.org/observium-community-latest.tar.gz
Puretaan tar paketti
tar zxvf observium-community-latest.tar.gz
Siirrytään observium hakemistoon
cd observium
Kopioidaan default konfiguraatio tiedosto
cp config.php.default config.php
Kirjautu tietokantaan ja luo uusi tietokanta Observiumille
mysql -u root -p
<mysql root password>
mysql> CREATE DATABASE observium DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
mysql> GRANT ALL PRIVILEGES ON observium.* TO 'observium'@'localhost'
-> IDENTIFIED BY '<observium db password>';
Avaa config.php tiedosto ja päivitä siihen tietokantasi tiedot.
// Database config $config['db_host'] = 'localhost'; $config['db_user'] = 'observium'; $config['db_pass'] = '<observium db password>'; $config['db_name'] = 'observium';
Aja seuraava komento. Tämä määrittää automaattisesti tietokantaasi taulut.
php includes/update/update.php
Luo hakemisto Observiumin lokille
mkdir logs
Avaa Apachen konfigurointi tiedosto
nano /etc/apache2/sites-available/default
ja muuta se seuraavanlaiseksi
<VirtualHost *:80>
ServerAdmin webmaster@localhost
DocumentRoot /opt/observium/html
<Directory />
Options FollowSymLinks
AllowOverride None
</Directory>
<Directory /opt/observium/html/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>
ErrorLog ${APACHE_LOG_DIR}/error.log
LogLevel warn
CustomLog ${APACHE_LOG_DIR}/access.log combined
ServerSignature On
</VirtualHost>
Ota käyttöön php mcrypt moduuli
php5enmod mcrypt
Ota käyttään Apachen moduuli mod_rewrite
a2enmod rewrite apache2ctl restart
Luo ensimmäinen käyttäjä Observiumiin. Käytetään tason 10., eli adminia.
cd /opt/observium
./adduser.php <username> <password> <level>
Esimerkiksi
./adduser.php admin passwd123 10
Luo uusi tiedosto /etc/cron.d/observium ja lisää seuraavat rivit. Cron on ajastusta varten.
33 */6 * * * root /opt/observium/discovery.php -h all >> /dev/null 2>&1 */5 * * * * root /opt/observium/discovery.php -h new >> /dev/null 2>&1 */5 * * * * root /opt/observium/poller-wrapper.py 2 >> /dev/null 2>&1
Siirry nyt http://ip-osoite ja kirjaudu Observiumiin luomillasi käyttäjätunnuksillasi.
Lisäkonfiguraatiot
Nämä lisäkonfiguraatiot ovat vapaehtoisia. Kaikki lisäkonfiguraatiot tehdään observiumin konfigurointi tiedostoon /opt/observium/config.php
Sähköpostilmoitukset
Tämä konfiguraatio sallii observiumin lähettävän sähköpostiin ilmoituksen palvelimesta. Muuta vain [email protected] sähköpostiosoitteeksi jonne tahdot ilmoitukset ja [email protected], domainisi josta lähetetään (esim. [email protected]). Sinulla tulee olla sähköpostipalvelin (esimerkiksi postfix) jolla lähetetään ilmoitukset sähköpostiisi.
Tämä ei toimi uusimman Communityn kanssa!
$config['poller-wrapper']['alerter'] = TRUE; $config['alerts']['alerter']['default']['descr'] = "Observium Alert"; $config['alerts']['alerter']['default']['type'] = "email"; $config['alerts']['alerter']['default']['contact'] = "[email protected]"; $config['alerts']['alerter']['default']['enable'] = TRUE; $config['email_from'] = "[email protected]"; $config['alerts']['alerter']['default']['enable'] = TRUE; $config['alerts']['email']['enable'] = TRUE;
Ilmoitusasetukset
Ilmoita jos portti on alhaalla. Oletuksena pois käytöstä.
$config['alerts']['port']['ifdown'] = TRUE;
$config['alerts']['port']['ifdown_types'] = array('core', 'transit', 'peering');
Ilmoita kun kaista on tietyn rajan yli per portti. Esimerkissä 85% ylittävän rajan lähetetään ilmoitus. Oletuksena pois käytöstä.
$config['alerts']['port_util_alert'] = TRUE; $config['alerts']['port_util_perc'] = 85;
Sovellukset
Ennen sovellusten käyttä, asenna Unix-Agent ensin ennen kuin alat käyttämään sovelluksia. Tätä tarvitaan suurimman osassa sovelluksista.
= Apache
Ota käyttään mod_status
a2enmod status
Käynnistä Apache2 uudelleen
service apache2 restart
Avaa mod_status konfigurointi
nano /etc/apache2/mod-available/status.conf
Sen tulisi olla seuraavanlainen:
ExtendedStatus On
<Location /server-status>
SetHandler server-status
Order deny,allow
Deny from all
Allow from 127.0.0.1 ::1
</Location>
Unix Agent
Asenna
sudo apt-get install xinetd
Kopioi /opt/observium/scripts/observium_agent_xinetd palvelimeen johon asennat juuri nyt /etc/xinet.d/observium_agent_xinetd hakemistoon.
Kopioi lisäksi /opt/observium/scripts/observium_agent palvelimeen johon asennat juuri nyt /usr/bin/observium_agent hakemistoon.
Käytä esimerkiksi SCP:tä:
scp /opt/observium/scripts/observium_agent_xinetd [email protected]:/etc/xinet.d/observium_agent_xinetd scp /opt/observium/scripts/observium_agent [email protected]:/usr/bin/observium_agent
Luo hakemistot
mkdir /usr/lib/observium_agent mkdir /usr/lib/observium_agent/local
Avaa observium_agent_xinetd tiedosto
nano /etc/xinetd.d/observium_agent_xinetd
ja määritä IP-osoite jota se kuuntelee:
only_from = 10.6.10.100 127.0.0.1 ::1
Käynnistä palvelu uudelleen
sudo service xinetd restart
Lisää tämä /opt/observium/config tiedostoon ottaaksesi käyttöön Unix-agent modulen:
$config['poller_modules']['unix-agent'] = 1;
Määritä käyttöoikeudet
chmod 744 /usr/bin/observium_agent chmod 744 -R /usr/lib/observium_agent/local/
Testaa:
Telnetillä:
telnet YourUnixServer.YourDomain.com 36602
Tai suoraan päätelaitteelta.
/usr/bin/observium_agent
Kopioi koko /opt/observium/scripts/agent-local hakemiston sisältä /usr/lib/observium_agent/local/ hakemiston alle.
WMI
http://jira.observium.org/secure/attachment/11319/WMIPoller-011013-1429-4.pdf
Asiakaslaitteet (SNMP)
Kaikki tuetut laitteet löytyvät täältä: http://www.observium.org/wiki/Supported_Devices
Varmista että palvelimesta pystyy muodostamaan yhteyden UDP:n portin 161 kautta päätelaitteeseen.
Debian / Ubuntu
Lisää asiakaslaite nimipalveluun A record.
Asenna smpd client pakettihallinnasta.
aptitude install snmpd
Avaa SNMP konfigurointi tiedosto
nano /etc/snmpd.conf
Poista risuaita riviltä 17 ja lisää risuaita riville 15.
# Listen for connections from the local system only #agentAddress udp:127.0.0.1:161 # Listen for connections on all interfaces (both IPv4 *and* IPv6) agentAddress udp:161,udp6:[::1]:161
Lisää risuaita riville 51 ja lisää rocommunity. Rocomminityyn (community = salasana) ja IP, jonka sallitaan hakevan tietoja.
#rocommunity public default -V systemonly rocommunity <community> <ip>
Esimerkiksi
rocommunity observium123 192.168.1.44
Lisää risuaita
#rouser authOnlyUser
Muuta syslocation (sijainti) ja sähköpostiosoite. Tähän sähköpostiosoitteeseen lähtetetään ilmoitukset ellei erikseen muuteta palvelimella tietoja.
sysLocation Helsinki sysContact [email protected]
Tallenna ja sulje tiedosto ja käynnistä palvelu uudelleen
service snmpd restart
Siirry observium palvelimelle ja lisää asiakaslaite konfiguraatioon.
cd /opt/observium
./add_device.php <hostname> <community> v2c
RouterOS
Luodaan ensimmäiseksi community trap observium jolla Observium-palvelin pystyy hakemaan tietoja asiakaslaitteelta.
/snmp community add name=observium addresses=0.0.0.0/0 security=none read-access=yes write-access=no
Otetaan käyttöön SNMP asiakas ja liitetään aikaisemmin luotu community trap observium siihen.
/snmp set enabled=yes location=Turku [email protected] trap-community=observium trap-target=10.0.0.5
Siirry observium palvelimelle ja lisää asiakaslaite konfiguraatioon.
cd /opt/observium
./add_device.php <hostname> <community> v2c
